Skip to content

quic: add missing documentation for stream.stopSending() and stream.r…#63681

Open
vishalranaut wants to merge 1 commit into
nodejs:mainfrom
vishalranaut:quic/document-stream-stopSending-resetStream
Open

quic: add missing documentation for stream.stopSending() and stream.r…#63681
vishalranaut wants to merge 1 commit into
nodejs:mainfrom
vishalranaut:quic/document-stream-stopSending-resetStream

Conversation

@vishalranaut
Copy link
Copy Markdown

@vishalranaut vishalranaut commented May 31, 2026

quic: add missing documentation for stream.stopSending() and stream.resetStream()

Fixes #63680


What this PR does

Adds missing documentation for two QuicStream methods that are implemented in the source but not documented:

  • stream.stopSending(code) — sends a STOP_SENDING frame to abort the readable side of the stream (half-close for incoming data)
  • stream.resetStream(code) — sends a RESET_STREAM frame to abort the writable side of the stream (half-close for outgoing data)

Both methods are important for protocols like WebTransport that require half-closing streams independently.

Why this matters

Without documentation, developers implementing WebTransport or other QUIC-based protocols had no way to discover or correctly use these methods from the official Node.js docs.

Changes made

  • Added stream.stopSending(code) entry to doc/api/quic.md under the QuicStream class section
  • Added stream.resetStream(code) entry to doc/api/quic.md under the QuicStream class section
  • Both entries follow the existing Node.js documentation format with YAML metadata, parameter types, and description

File changed: doc/api/quic.md


Checklist

  • make lint passes
  • Documentation only — no source code modified
  • Follows the Node.js documentation style guide
  • Added added: REPLACEME version metadata as required for new doc entries

@nodejs-github-bot
Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/quic

@nodejs-github-bot nodejs-github-bot added doc Issues and PRs related to the documentations. quic Issues and PRs related to the QUIC implementation / HTTP/3. labels May 31, 2026
Comment thread doc/api/quic.md
independent half-closing per direction without tearing down the entire
stream.

```mjs
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Care to add a matching cjs code block?

Comment thread doc/api/quic.md
independent half-closing per direction without tearing down the entire
stream.

```mjs
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ditto

Comment thread doc/api/quic.md
### `stream.stopSending([code])`

<!-- YAML
added: REPLACEME
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This seems to have been released already in 26.2.0: 7e6b77b

Might be getting the wrong commit though, worth validating with @jasnell

Comment thread doc/api/quic.md
### `stream.resetStream([code])`

<!-- YAML
added: REPLACEME
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems to have already been released, I am not sure when though

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc Issues and PRs related to the documentations. quic Issues and PRs related to the QUIC implementation / HTTP/3.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

quic: QuicStream missing docu for stopSending, and resetStream

4 participants