From 922a1b03b638e19d8d29efdaab93d5c9455c02ce Mon Sep 17 00:00:00 2001 From: James M Snell Date: Wed, 5 Sep 2018 11:33:20 -0700 Subject: url: docs deprecate legacy url API MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PR-URL: https://github.com/nodejs/node/pull/22715 Reviewed-By: Michaël Zasso Reviewed-By: Refael Ackermann Reviewed-By: Vse Mozhet Byt Reviewed-By: Anna Henningsen Reviewed-By: Trivikram Kamat Reviewed-By: Ruben Bridgewater Reviewed-By: Gus Caplan Reviewed-By: Matteo Collina Reviewed-By: Tiancheng "Timothy" Gu Reviewed-By: Luigi Pinca Reviewed-By: Colin Ihrig --- doc/api/deprecations.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) (limited to 'doc/api/deprecations.md') diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md index 10ffa49f4d..04ff5f5ca0 100644 --- a/doc/api/deprecations.md +++ b/doc/api/deprecations.md @@ -1050,6 +1050,16 @@ deprecated along with the undocumented aliases `crypto.prng()` and `crypto.rng()` in favor of [`crypto.randomBytes()`][] and will be removed in a future release. + +### DEP0116: Legacy URL API + +Type: Documentation + +The [Legacy URL API][] is deprecated. This includes [`url.format()`][], +[`url.parse()`][], [`url.resolve()`][], and the [legacy `urlObject`][]. Please +use the [WHATWG URL API][] instead. + + [`--pending-deprecation`]: cli.html#cli_pending_deprecation [`Buffer.allocUnsafeSlow(size)`]: buffer.html#buffer_class_method_buffer_allocunsafeslow_size [`Buffer.from(array)`]: buffer.html#buffer_class_method_buffer_from_array @@ -1098,6 +1108,7 @@ future release. [`os.tmpdir()`]: os.html#os_os_tmpdir [`process.env`]: process.html#process_process_env [`punycode`]: punycode.html +[`REPLServer.clearBufferedCommand()`]: repl.html#repl_replserver_clearbufferedcommand [`require.extensions`]: modules.html#modules_require_extensions [`script.createCachedData()`]: vm.html#vm_script_createcacheddata [`setInterval()`]: timers.html#timers_setinterval_callback_delay_args @@ -1108,6 +1119,9 @@ future release. [`tls.TLSSocket`]: tls.html#tls_class_tls_tlssocket [`tls.checkServerIdentity()`]: tls.html#tls_tls_checkserveridentity_hostname_cert [`tls.createSecureContext()`]: tls.html#tls_tls_createsecurecontext_options +[`url.format()`]: url.html#url_url_format_urlobject +[`url.parse()`]: url.html#url_url_parse_urlstring_parsequerystring_slashesdenotehost +[`url.resolve()`]: url.html#url_url_resolve_from_to [`util._extend()`]: util.html#util_util_extend_target_source [`util.debug()`]: util.html#util_util_debug_string [`util.error()`]: util.html#util_util_error_strings @@ -1139,5 +1153,7 @@ future release. [alloc_unsafe_size]: buffer.html#buffer_class_method_buffer_allocunsafe_size [from_arraybuffer]: buffer.html#buffer_class_method_buffer_from_arraybuffer_byteoffset_length [from_string_encoding]: buffer.html#buffer_class_method_buffer_from_string_encoding +[Legacy URL API]: url.html#url_legacy_url_api +[legacy `urlObject`]: url.html#url_legacy_urlobject [NIST SP 800-38D]: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf -[`REPLServer.clearBufferedCommand()`]: repl.html#repl_replserver_clearbufferedcommand +[WHATWG URL API]: url.html#url_the_whatwg_url_api -- cgit v1.2.3