diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md index 7e6347927962b2..4da031cb4d326b 100644 --- a/doc/api/deprecations.md +++ b/doc/api/deprecations.md @@ -2660,11 +2660,15 @@ future release. +> Stability: 0 - Deprecated: 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. @@ -1992,6 +1998,8 @@ url.resolve('http://example.com/', '/one'); // 'http://example.com/one' url.resolve('http://example.com/one', '/two'); // 'http://example.com/two' ``` +Because it invokes the deprecated [`url.parse()`][] internally, `url.resolve()` is itself deprecated. + To achieve the same result using the WHATWG URL API: ```js