Skip to content

http2: deprecate priority #58313

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 29, 2025
Merged

http2: deprecate priority #58313

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions doc/api/deprecations.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3935,10 +3935,25 @@ The `node:_stream_duplex`, `node:_stream_passthrough`, `node:_stream_readable`,
`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`

<!-- YAML
changes:
- version: REPLACEME
pr-url: https://github.com/nodejs/node/pull/58313
description: Documentation-only deprecation.
-->

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
Expand Down
12 changes: 10 additions & 2 deletions doc/api/http2.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1457,6 +1457,7 @@ numeric stream identifier.

<!-- YAML
added: v8.4.0
deprecated: REPLACEME
-->

* `options` {Object}
Expand All @@ -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`

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

A current state of this `Http2Stream`.

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