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

readable.some(fn[, options])

參數

• fn <Function>|<AsyncFunction>調用流的每個塊的函數。
  • data <any> 來自流的數據塊。
  • options <Object>
    • signal <AbortSignal> 如果流被破壞則中止，允許提前中止 fn 調用。
• options <Object>
  • concurrency <number> fn 的最大並發調用一次調用流。 默認： 1 。
  • signal <AbortSignal> 允許在信號中止時銷毀流。
• 返回： <Promise> 如果 fn 至少為其中一個塊返回了一個真實值，則該承諾評估為 true。

此方法類似於Array.prototype.some，並在流中的每個塊上調用fn，直到等待的返回值為true(或任何真值)。一旦對塊等待返回值的 fn 調用是真實的，流就會被銷毀，並且用 true 來履行承諾。如果對塊的 fn 調用都沒有返回真值，則使用 false 實現承諾。

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

// With a synchronous predicate.
await Readable.from([1, 2, 3, 4]).some((x) => x > 2); // true
await Readable.from([1, 2, 3, 4]).some((x) => x < 0); // false

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