Node.js stream.Readable.iterator([options])用法及代码示例

readable.iterator([options])

参数

• options <Object>
  • destroyOnReturn <boolean> 当设置为 false 时，在异步迭代器上调用 return 或使用 break 、 return 或 throw 退出 for await...of 迭代不会破坏流。 默认： true 。
• 返回： <AsyncIterator> 以使用流。

如果 for await...of 循环由 return 、 break 或 throw 退出，或者如果迭代器应该销毁流在迭代期间发出错误。

const { Readable } = require('node:stream');

async function printIterator(readable) {
  for await (const chunk of readable.iterator({ destroyOnReturn: false })) {
    console.log(chunk); // 1
    break;
  }

  console.log(readable.destroyed); // false

  for await (const chunk of readable.iterator({ destroyOnReturn: false })) {
    console.log(chunk); // Will print 2 and then 3
  }

  console.log(readable.destroyed); // True, stream was totally consumed
}

async function printSymbolAsyncIterator(readable) {
  for await (const chunk of readable) {
    console.log(chunk); // 1
    break;
  }

  console.log(readable.destroyed); // true
}

async function showBoth() {
  await printIterator(Readable.from([1, 2, 3]));
  await printSymbolAsyncIterator(Readable.from([1, 2, 3]));
}

showBoth();