From 6cc1d52327a11843aa995b2aaeae03439cdd6214 Mon Sep 17 00:00:00 2001 From: Matteo Collina Date: Thu, 29 May 2025 10:09:05 +0200 Subject: [PATCH 1/2] doc: deprecate HTTP/2 priority signaling Signed-off-by: Matteo Collina Co-authored-by: Antoine du Hamel PR-URL: https://github.com/nodejs/node/pull/58313 Reviewed-By: Marco Ippolito Reviewed-By: James M Snell Reviewed-By: Darshan Sen Reviewed-By: Tim Perry --- doc/api/deprecations.md | 44 +++++++++++++++++++++++++++++++++++++++++ doc/api/http2.md | 12 +++++++++-- 2 files changed, 54 insertions(+), 2 deletions(-) diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md index 59ccb616adae1d..d684a076e8e59b 100644 --- a/doc/api/deprecations.md +++ b/doc/api/deprecations.md @@ -3897,10 +3897,54 @@ of built-in modules. This was incomplete and matched the already deprecated `repl._builtinLibs` ([DEP0142][]) instead it's better to rely upon `require('node:module').builtinModules`. +### DEP0192: `require('node:_tls_common')` and `require('node:_tls_wrap')` + + + +Type: Documentation-only + +The `node:_tls_common` and `node:_tls_wrap` modules are deprecated as they should be considered +an internal nodejs implementation rather than a public facing API, use `node:tls` instead. + +### DEP0193: `require('node:_stream_*')` + + + +Type: Documentation-only + +The `node:_stream_duplex`, `node:_stream_passthrough`, `node:_stream_readable`, `node:_stream_transform`, +`node:_stream_wrap` and `node:_stream_writable` modules are deprecated as they should be considered +an internal nodejs implementation rather than a public facing API, use `node:stream` instead. + +### DEP0194: `require('node:http2').Http2Stream.priority` + + + +Type: Documentation-only + +The support for priority signaling has been deprecated in the [RFC 9113][], and +will be removed in future versions of Node.js. + [DEP0142]: #dep0142-repl_builtinlibs [NIST SP 800-38D]: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf [RFC 6066]: https://tools.ietf.org/html/rfc6066#section-3 [RFC 8247 Section 2.4]: https://www.rfc-editor.org/rfc/rfc8247#section-2.4 +[RFC 9113]: https://datatracker.ietf.org/doc/html/rfc9113#section-5.3.1 [WHATWG URL API]: url.md#the-whatwg-url-api [`"exports"` or `"main"` entry]: packages.md#main-entry-point-export [`'uncaughtException'`]: process.md#event-uncaughtexception diff --git a/doc/api/http2.md b/doc/api/http2.md index 36b9cd1ccfce8b..42c91ff734f1a3 100644 --- a/doc/api/http2.md +++ b/doc/api/http2.md @@ -1457,6 +1457,7 @@ numeric stream identifier. * `options` {Object} @@ -1474,6 +1475,9 @@ added: v8.4.0 Updates the priority for this `Http2Stream` instance. +The support for priority signaling has been deprecated in the [RFC 9113][], and +will be removed in future versions of Node.js. + #### `http2stream.rstCode` * `headers` {HTTP/2 Headers Object} | {Array} @@ -1087,7 +1092,8 @@ added: v8.4.0 created stream is dependent on. * `weight` {number} Specifies the relative dependency of a stream in relation to other streams with the same `parent`. The value is a number between `1` - and `256` (inclusive). + and `256` (inclusive). This has been **deprecated** in [RFC 9113][], and + support for it will be removed in future versions of Node.js. * `waitForTrailers` {boolean} When `true`, the `Http2Stream` will emit the `'wantTrailers'` event after the final `DATA` frame has been sent. * `signal` {AbortSignal} An AbortSignal that may be used to abort an ongoing @@ -1460,6 +1466,9 @@ added: v8.4.0 deprecated: REPLACEME --> +> Stability: 0 - Deprecated: support for priority signaling has been deprecated +> in the [RFC 9113][] and is no longer supported in Node.js. + * `options` {Object} * `exclusive` {boolean} When `true` and `parent` identifies a parent Stream, this stream is made the sole direct dependency of the parent, with @@ -1475,9 +1484,6 @@ deprecated: REPLACEME Updates the priority for this `Http2Stream` instance. -The support for priority signaling has been deprecated in the [RFC 9113][], and -will be removed in future versions of Node.js. - #### `http2stream.rstCode` Provides miscellaneous information about the current state of the