url.resolve(from, to)

版本历史

版本	变更
v14.17.0	弃用已撤销。状态更改为“旧版”。
v11.0.0	旧版的网址 API 已弃用。使用 WHATWG 网址 API。
v6.6.0	当 `from` 和 `to` 引用同一主机时，`auth` 字段现在保持不变。
v6.0.0	现在 `to` 参数包含主机名，`auth` 字段被清除。
v6.5.0, v4.6.2	字段 `port` 现在已正确复制。
v0.1.25	新增于: v0.1.25

稳定性: 3 - 旧版: 改为使用 WHATWG URL API 。

from <string> 正在解析的基本网址。
to <string> 正在解析的 HREF 网址。

url.resolve() 方法以类似于 Web 浏览器解析锚标记 HREF 的方式解析相对于基本网址的目标网址。

const url = require('url');
url.resolve('/one/two/three', 'four');         // '/one/two/four'
url.resolve('http://example.com/', '/one');    // 'http://example.com/one'
url.resolve('http://example.com/one', '/two'); // 'http://example.com/two'

可以使用 WHATWG 网址 API 获得相同的结果：

function resolve(from, to) {
  const resolvedUrl = new URL(to, new URL(from, 'resolve://'));
  if (resolvedUrl.protocol === 'resolve:') {
    // `from` is a relative URL.
    const { pathname, search, hash } = resolvedUrl;
    return pathname + search + hash;
  }
  return resolvedUrl.toString();
}

resolve('/one/two/three', 'four');         // '/one/two/four'
resolve('http://example.com/', '/one');    // 'http://example.com/one'
resolve('http://example.com/one', '/two'); // 'http://example.com/two'

History

Version	Changes
v14.17.0	Deprecation revoked. Status changed to "Legacy".
v11.0.0	The Legacy URL API is deprecated. Use the WHATWG URL API.
v6.6.0	The `auth` fields are now kept intact when `from` and `to` refer to the same host.
v6.0.0	The `auth` fields is cleared now the `to` parameter contains a hostname.
v6.5.0, v4.6.2	The `port` field is copied correctly now.
v0.1.25	Added in: v0.1.25

Stability: 3 - Legacy: Use the WHATWG URL API instead.

from <string> The Base URL being resolved against.
to <string> The HREF URL being resolved.

The url.resolve() method resolves a target URL relative to a base URL in a manner similar to that of a Web browser resolving an anchor tag HREF.

const url = require('url');
url.resolve('/one/two/three', 'four');         // '/one/two/four'
url.resolve('http://example.com/', '/one');    // 'http://example.com/one'
url.resolve('http://example.com/one', '/two'); // 'http://example.com/two'

You can achieve the same result using the WHATWG URL API:

function resolve(from, to) {
  const resolvedUrl = new URL(to, new URL(from, 'resolve://'));
  if (resolvedUrl.protocol === 'resolve:') {
    // `from` is a relative URL.
    const { pathname, search, hash } = resolvedUrl;
    return pathname + search + hash;
  }
  return resolvedUrl.toString();
}

resolve('/one/two/three', 'four');         // '/one/two/four'
resolve('http://example.com/', '/one');    // 'http://example.com/one'
resolve('http://example.com/one', '/two'); // 'http://example.com/two'