url.resolve(from, to)

版本历史

版本	变更
v15.13.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 是相对的 URL，则使用的基本的 URL。
to <string> 要解析的目标 URL。

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

const url = require('node: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 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'

History

Version	Changes
v15.13.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 to use if to is a relative URL.
to <string> The target URL to resolve.

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.

const url = require('node: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'

To 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'