Skip to main content

Demo 34

Stream backpressure

When stream.write returns false, wait for drain before writing more.

fully simulatedcurated scenariodoes not execute real code
Short answer

The key output order is false -> safe to write. Backpressure is the stream telling you to pause until the buffer catches up.

Real-world bug this helps solve

A Node callback, timer, I/O task, stream, or worker-pool job runs later than expected. This prevents memory spikes in file uploads, log pipelines, CSV exports, proxies, and Node API gateways.

Common wrong assumption

Ignoring the boolean return value from stream.write.

Fix direction

Separate sync work, microtasks, timers, I/O, check callbacks, and worker-pool work in your mental model.

Fixed code pattern
setImmediate(runAfterIO);
// Avoid long nextTick loops that starve other phases.
Visual proof

The console lane proves the visible order: false -> safe to write. The active line and queues show why source order changed.

How to verify in a real app

Add timestamps around callbacks and inspect Node diagnostics, logs, or profiler output to confirm the runtime phase that is delaying work.

Share
Loading visual timeline...

Related cases

Continue with nearby confusion while the mental model is fresh.

Recommended next

Was this clear?

This stays local for now. It helps you track where the product still needs sharper cases.

Send detail