FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

doc: deprecate HTTP/2 priority signaling · nodejs/node@af0446e · GitHub

/ node Public

Commit af0446e

Browse files
authored and
targos
committed
doc: deprecate HTTP/2 priority signaling
Signed-off-by: Matteo Collina <hello@matteocollina.com> Co-authored-by: Antoine du Hamel <duhamelantoine1995@gmail.com> PR-URL: #58313 Backport-PR-URL: #58542 Reviewed-By: Marco Ippolito <marcoippolito54@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Darshan Sen <raisinten@gmail.com> Reviewed-By: Tim Perry <pimterry@gmail.com>
1 parent 8a1eaea commit af0446e

2 files changed

Lines changed: 54 additions & 2 deletions

File tree

‎doc/api/deprecations.md‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3897,10 +3897,54 @@ of built-in modules. This was incomplete and matched the already deprecated
38973897
`repl._builtinLibs` ([DEP0142][]) instead it's better to rely
38983898
upon `require('node:module').builtinModules`.
38993899

3900+
### DEP0192: `require('node:_tls_common')` and `require('node:_tls_wrap')`
3901+
3902+
<!-- YAML
3903+
changes:
3904+
- version: REPLACEME
3905+
pr-url: https://github.com/nodejs/node/pull/57643
3906+
description: Documentation-only deprecation.
3907+
-->
3908+
3909+
Type: Documentation-only
3910+
3911+
The `node:_tls_common` and `node:_tls_wrap` modules are deprecated as they should be considered
3912+
an internal nodejs implementation rather than a public facing API, use `node:tls` instead.
3913+
3914+
### DEP0193: `require('node:_stream_*')`
3915+
3916+
<!-- YAML
3917+
changes:
3918+
- version: REPLACEME
3919+
pr-url: https://github.com/nodejs/node/pull/58337
3920+
description: Documentation-only deprecation.
3921+
-->
3922+
3923+
Type: Documentation-only
3924+
3925+
The `node:_stream_duplex`, `node:_stream_passthrough`, `node:_stream_readable`, `node:_stream_transform`,
3926+
`node:_stream_wrap` and `node:_stream_writable` modules are deprecated as they should be considered
3927+
an internal nodejs implementation rather than a public facing API, use `node:stream` instead.
3928+
3929+
### DEP0194: `require('node:http2').Http2Stream.priority`
3930+
3931+
<!-- YAML
3932+
changes:
3933+
- version: REPLACEME
3934+
pr-url: https://github.com/nodejs/node/pull/58313
3935+
description: Documentation-only deprecation.
3936+
-->
3937+
3938+
Type: Documentation-only
3939+
3940+
The support for priority signaling has been deprecated in the [RFC 9113][], and
3941+
will be removed in future versions of Node.js.
3942+
39003943
[DEP0142]: #dep0142-repl_builtinlibs
39013944
[NIST SP 800-38D]: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf
39023945
[RFC 6066]: https://tools.ietf.org/html/rfc6066#section-3
39033946
[RFC 8247 Section 2.4]: https://www.rfc-editor.org/rfc/rfc8247#section-2.4
3947+
[RFC 9113]: https://datatracker.ietf.org/doc/html/rfc9113#section-5.3.1
39043948
[WHATWG URL API]: url.md#the-whatwg-url-api
39053949
[`"exports"` or `"main"` entry]: packages.md#main-entry-point-export
39063950
[`'uncaughtException'`]: process.md#event-uncaughtexception

‎doc/api/http2.md‎

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1457,6 +1457,7 @@ numeric stream identifier.
14571457

14581458
<!-- YAML
14591459
added: v8.4.0
1460+
deprecated: REPLACEME
14601461
-->
14611462

14621463
* `options` {Object}
@@ -1474,6 +1475,9 @@ added: v8.4.0
14741475

14751476
Updates the priority for this `Http2Stream` instance.
14761477

1478+
The support for priority signaling has been deprecated in the [RFC 9113][], and
1479+
will be removed in future versions of Node.js.
1480+
14771481
#### `http2stream.rstCode`
14781482

14791483
<!-- YAML
@@ -1583,8 +1587,11 @@ Provides miscellaneous information about the current state of the
15831587
remotely.
15841588
* `sumDependencyWeight` {number} The sum weight of all `Http2Stream`
15851589
instances that depend on this `Http2Stream` as specified using
1586-
`PRIORITY` frames.
1587-
* `weight` {number} The priority weight of this `Http2Stream`.
1590+
`PRIORITY` frames. This has been **deprecated** in [RFC 9113][], and
1591+
support for it will be removed in future versions of Node.js.
1592+
* `weight` {number} The priority weight of this `Http2Stream`. This has been
1593+
**deprecated** in [RFC 9113][], and support for it will be removed in future
1594+
versions of Node.js.
15881595

15891596
A current state of this `Http2Stream`.
15901597

@@ -4883,6 +4890,7 @@ you need to implement any fall-back behavior yourself.
48834890
[RFC 7838]: https://tools.ietf.org/html/rfc7838
48844891
[RFC 8336]: https://tools.ietf.org/html/rfc8336
48854892
[RFC 8441]: https://tools.ietf.org/html/rfc8441
4893+
[RFC 9113]: https://datatracker.ietf.org/doc/html/rfc9113#section-5.3.1
48864894
[Sensitive headers]: #sensitive-headers
48874895
[`'checkContinue'`]: #event-checkcontinue
48884896
[`'connect'`]: #event-connect

0 commit comments

Comments
 (0)
Back | FazBrowse Home | New Git URL