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

readable.forEach(fn[, options])

参数

• fn <Function>|<AsyncFunction>调用流的每个块的函数。
  • data <any> 来自流的数据块。
  • options <Object>
    • signal <AbortSignal> 如果流被破坏则中止，允许提前中止 fn 调用。
• options <Object>
  • concurrency <number> fn 的最大并发调用一次调用流。 默认： 1 。
  • signal <AbortSignal> 允许在信号中止时销毁流。
• 返回： <Promise> 流完成时的承诺。

此方法允许迭代流。对于流中的每个块，将调用fn 函数。如果fn 函数返回一个promise - 该promise 将是await ed。

此方法与for await...of 循环的不同之处在于它可以选择性地同时处理块。此外，forEach 迭代只能通过传递 signal 选项并中止相关的 AbortController 来停止，而 for await...of 可以通过 break 或 return 停止。在任何一种情况下，流都将被销毁。

该方法与监听 'data' 事件的不同之处在于它在底层机器中使用了 readable 事件，并且可以限制并发fn调用的数量。

import { Readable } from 'node:stream';
import { Resolver } from 'node:dns/promises';

// With a synchronous predicate.
for await (const chunk of Readable.from([1, 2, 3, 4]).filter((x) => x > 2)) {
  console.log(chunk); // 3, 4
}
// With an asynchronous predicate, making at most 2 queries at a time.
const resolver = new Resolver();
const dnsResults = Readable.from([
  'nodejs.org',
  'openjsf.org',
  'www.linuxfoundation.org',
]).map(async (domain) => {
  const { address } = await resolver.resolve4(domain, { ttl: true });
  return address;
}, { concurrency: 2 });
await dnsResults.forEach((result) => {
  // Logs result, similar to `for await (const result of dnsResults)`
  console.log(result);
});
console.log('done'); // Stream has finished