• size {number} 要读取的数据的字节数。
    • 返回: {string|Buffer|null|any}

    从内部缓冲拉取并返回数据。 如果没有可读的数据，则返回 null。 默认情况下，readable.read() 返回的数据是 Buffer 对象，除非使用 readable.setEncoding() 指定字符编码或流处于对象模式。

    可选的 size 参数指定要读取的特定字节数。 如果无法读取 size 个字节，则除非流已结束，否则将会返回 null，在这种情况下，将会返回内部 buffer 中剩余的所有数据。

    如果没有指定 size 参数，则返回内部缓冲中的所有数据。

    size 参数必须小于或等于 1 GiB。

    readable.read() 应该只对处于暂停模式的可读流调用。 在流动模式中，readable.read() 会自动调用直到内部缓冲的数据完全耗尽。

    1. const readable = getReadableStreamSomehow();
    3. // 'readable' may be triggered multiple times as data is buffered in
    4. readable.on('readable', () => {
    5.   let chunk;
    6.   console.log('Stream is readable (new data received in buffer)');
    7.   // Use a loop to make sure we read all currently available data
    8.   while (null !== (chunk = readable.read())) {
    9.     console.log(`读取 ${chunk.length} 字节的数据`);
    10.   }
    11. });
    13. // 'end' will be triggered once when there is no more data available
    14. readable.on('end', () => {
    15.   console.log('Reached end of stream.');
    16. });

    Each call to readable.read() returns a chunk of data, or null. The chunks are not concatenated. A while loop is necessary to consume all data currently in the buffer. When reading a large file .read() may return null, having consumed all buffered content so far, but there is still more data to come not yet buffered. In this case a new 'readable' event will be emitted when there is more data in the buffer. Finally the 'end' event will be emitted when there is no more data to come.

    Therefore to read a file’s whole contents from a readable, it is necessary to collect chunks across multiple 'readable' events:

    1. const chunks = [];
    3. readable.on('readable', () => {
    4.   let chunk;
    5.   while (null !== (chunk = readable.read())) {
    6.     chunks.push(chunk);
    7.   }
    8. });
    10. readable.on('end', () => {
    11.   const content = chunks.join('');
    12. });

    使用 readable.read() 处理数据时，while 循环是必需的。 只有在 readable.read() 返回 null 之后，才会触发 ['readable']。

    对象模式下的可读流将会始终从调用 [readable.read(size)][stream-read] 返回单个子项，而不管 size 参数的值如何。

    如果 readable.read() 返回一个数据块，则 'data' 事件也会触发。

    在 ['end'] 事件触发后再调用 [stream.read([size])][stream-read] 会返回 null。 不会引发运行时错误。