diff --git a/doc/api/stream.md b/doc/api/stream.md index 2cc239d9c9cb861..98fbd8e0686e09d 100644 --- a/doc/api/stream.md +++ b/doc/api/stream.md @@ -1907,8 +1907,9 @@ This method allows easily obtaining the contents of a stream. If the stream is in [object mode][object-mode] an array of its contents is returned. If the stream is not in object mode a Buffer containing its data is returned. -As this method reads the entire stream into memory, it negates many of the -benefits of streams and should not be used in performance sensitive situations. +As this method reads the entire stream into memory, it negates the benefits of +streams. It's intended for interoperability and convenience, not as the primary +way to consume streams. ```mjs import { Readable } from 'stream';