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();