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

readable.find(fn[, options])

参数

• fn <Function>|<AsyncFunction>调用流的每个块的函数。
  • data <any> 来自流的数据块。
  • options <Object>
    • signal <AbortSignal> 如果流被破坏则中止，允许提前中止 fn 调用。
• options <Object>
  • concurrency <number> fn 的最大并发调用一次调用流。 默认： 1 。
  • signal <AbortSignal> 允许在信号中止时销毁流。
• 返回： <Promise> 一个对第一个块进行评估的承诺，其中 fn 评估为真值，如果没有找到元素，则返回 undefined。

此方法类似于 Array.prototype.find 并在流中的每个块上调用 fn 以查找具有 fn 真实值的块。一旦 fn 调用的等待返回值是真实的，流就会被销毁，并且承诺会用 fn 返回真实值的值来实现。如果对块的所有 fn 调用都返回一个虚假值，则使用 undefined 实现承诺。

import { Readable } from 'node:stream';
import { stat } from 'node:fs/promises';

// With a synchronous predicate.
await Readable.from([1, 2, 3, 4]).find((x) => x > 2); // 3
await Readable.from([1, 2, 3, 4]).find((x) => x > 0); // 1
await Readable.from([1, 2, 3, 4]).find((x) => x > 10); // undefined

// With an asynchronous predicate, making at most 2 file checks at a time.
const foundBigFile = await Readable.from([
  'file1',
  'file2',
  'file3',
]).find(async (fileName) => {
  const stats = await stat(fileName);
  return stat.size > 1024 * 1024;
}, { concurrency: 2 });
console.log(foundBigFile); // File name of large file, if any file in the list is bigger than 1MB
console.log('done'); // Stream has finished