Revise backpressure examples in streams documentation

[baskakov]

Discussed here: https://stackoverflow.com/questions/79821132/node-js-back-pressure-documentation-whats-the-relevance-of-their-example Original backpressure example contains following oddities: 1) Incorrect zip example 2) Incorrect assumption that zip console command loads full file into memory. Updated examples to demonstrate file compression using Node.js streams with backpressure handling.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
nodejs-learn	Ready	Preview	Jun 28, 2026 10:18pm

[cursor]

PR Summary

Low Risk
Documentation-only edits to backpressuring-in-streams.md; no runtime or API behavior changes.

Overview
Replaces the old shell zip vs Node gzip pipe comparison with a clearer progression on the same ~9 GB file: readFileSync + gzipSync (buffer/heap limits), then manual data handlers that ignore write() return false (unbounded buffers / OOM), then inp.pipe(gzip).pipe(out) with prose on pause/drain/resume.

Removes the narrative that zip(1) produced a corrupt file while the stream version succeeded. The existing pump/pipeline callout after the pipe snippet is unchanged.

^{Reviewed by Cursor Bugbot for commit e094691. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

👋 Codeowner Review Request

The following codeowners have been identified for the changed files:

Team reviewers: @nodejs/streams

Please review the changes when you have a chance. Thank you! 🙏

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Updates the backpressure module to better illustrate memory/throughput implications of buffering vs streaming in Node.js compression examples.

Changes:

• Replaces the zip(1) example with fs.readFileSync + zlib.gzipSync examples (CJS + ESM).
• Adds an explicit “streams without backpressure” example plus an explanation of why it can OOM.
• Removes the prior note about comparing resulting archives.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[avivkeller]

Bump @baskakov

[baskakov]

@avivkeller Thanks! Done. Rebased changes in a single commit

[baskakov]

@avivkeller I have resolved all issues. Merged as a single commit. Whenever you have time, I'd really appreciate another review. Thanks!