diff --git a/doc/api/stream.md b/doc/api/stream.md index d80837022ba500..b6bd4495e6df33 100644 --- a/doc/api/stream.md +++ b/doc/api/stream.md @@ -1197,7 +1197,10 @@ print(fs.createReadStream('file')).catch(console.log); If the loop terminates with a `break` or a `throw`, the stream will be destroyed. In other terms, iterating over a stream will consume the stream -fully. +fully. The stream will be read in chunks of size equal to the `highWaterMark` +option. In the code example above, data will be in a single chunk if the file +has less then 64kb of data because no `highWaterMark` option is provided to +[`fs.createReadStream()`][]. ### Duplex and Transform Streams