Skip to content

doc: clarify stream construct promise handling#63349

Closed
MukundaKatta wants to merge 1 commit into
nodejs:mainfrom
MukundaKatta:codex/doc-stream-construct-promise
Closed

doc: clarify stream construct promise handling#63349
MukundaKatta wants to merge 1 commit into
nodejs:mainfrom
MukundaKatta:codex/doc-stream-construct-promise

Conversation

@MukundaKatta
Copy link
Copy Markdown

Refs: #39992

Documents that stream _construct() implementations may either call the callback or return a promise, and that doing both is invalid. The clarification is added to both writable and readable _construct() docs because they share the same construct behavior.

Validation:

  • node tools/lint-md/lint-md.mjs doc/api/stream.md
  • git diff --check
  • Runtime probe that a promise-returning Readable construct delays _read() until fulfillment

@nodejs-github-bot nodejs-github-bot added doc Issues and PRs related to the documentations. stream Issues and PRs related to the stream subsystem. labels May 15, 2026
@MukundaKatta
Copy link
Copy Markdown
Author

Pulling this back. Sorry for the rate.

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. stream Issues and PRs related to the stream subsystem.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants