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