@@ -546,8 +546,8 @@ The `writable.uncork()` method flushes all data buffered since
546
546
[ ` stream.cork() ` ] [ ] was called.
547
547
548
548
When using [ ` writable.cork() ` ] [ ] and ` writable.uncork() ` to manage the buffering
549
- of writes to a stream, it is recommended that calls to ` writable.uncork() ` be
550
- deferred using ` process.nextTick() ` . Doing so allows batching of all
549
+ of writes to a stream, defer calls to ` writable.uncork() ` using
550
+ ` process.nextTick() ` . Doing so allows batching of all
551
551
` writable.write() ` calls that occur within a given Node.js event loop phase.
552
552
553
553
``` js
@@ -701,7 +701,7 @@ stop until the [`'drain'`][] event is emitted.
701
701
While a stream is not draining, calls to ` write() ` will buffer ` chunk ` , and
702
702
return false. Once all currently buffered chunks are drained (accepted for
703
703
delivery by the operating system), the ` 'drain' ` event will be emitted.
704
- It is recommended that once ` write() ` returns false, no more chunks be written
704
+ Once ` write() ` returns false, do not write more chunks
705
705
until the ` 'drain' ` event is emitted. While calling ` write() ` on a stream that
706
706
is not draining is allowed, Node.js will buffer all written chunks until
707
707
maximum memory usage occurs, at which point it will abort unconditionally.
@@ -861,10 +861,9 @@ to consume data from a single stream. Specifically, using a combination
861
861
of ` on('data') ` , ` on('readable') ` , ` pipe() ` , or async iterators could
862
862
lead to unintuitive behavior.
863
863
864
- Use of the ` readable.pipe() ` method is recommended for most users as it has been
865
- implemented to provide the easiest way of consuming stream data. Developers that
866
- require more fine-grained control over the transfer and generation of data can
867
- use the [ ` EventEmitter ` ] [ ] and ` readable.on('readable') ` /` readable.read() `
864
+ ` readable.pipe() ` provides the easiest way to consume stream data. Developers
865
+ that require more fine-grained control over the transfer and generation of data
866
+ can use the [ ` EventEmitter ` ] [ ] and ` readable.on('readable') ` /` readable.read() `
868
867
or the ` readable.pause() ` /` readable.resume() ` APIs.
869
868
870
869
#### Class: ` stream.Readable `
0 commit comments