From 2f1ae9eebb65db3ae2bffd9e5dde6ff0a8b66219 Mon Sep 17 00:00:00 2001 From: Matteo Collina Date: Fri, 11 Jan 2019 12:53:37 +0100 Subject: [PATCH] doc: revert incorrect change on readable._read https://github.com/nodejs/node/pull/17979 introduced a change in the doc that was not correct about _read always being called asynchronously. This does not hold true when it is in flowing mode. See: https://github.com/nodejs/node/pull/17979 Fixes: https://github.com/nodejs/node/issues/24919 PR-URL: https://github.com/nodejs/node/pull/25442 Reviewed-By: Anna Henningsen Reviewed-By: Luigi Pinca Reviewed-By: Yuta Hiroto --- doc/api/stream.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/doc/api/stream.md b/doc/api/stream.md index 6518b45e8b4f82..c35c799129c8e5 100644 --- a/doc/api/stream.md +++ b/doc/api/stream.md @@ -1858,10 +1858,6 @@ const myReadable = new Readable({ #### readable.\_read(size) * `size` {number} Number of bytes to read asynchronously @@ -1881,9 +1877,7 @@ when `_read()` is called again after it has stopped should it resume pushing additional data onto the queue. Once the `readable._read()` method has been called, it will not be called again -until the [`readable.push()`][stream-push] method is called. `readable._read()` -is guaranteed to be called only once within a synchronous execution, i.e. a -microtick. +until the [`readable.push()`][stream-push] method is called. The `size` argument is advisory. For implementations where a "read" is a single operation that returns data can use the `size` argument to determine how