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

readable.every(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.every 並在流中的每個塊上調用 fn 以檢查所有等待的返回值是否為 fn 的真實值。一旦對塊等待返回值的 fn 調用是虛假的，流就會被銷毀，並且用 false 來履行承諾。如果對塊的所有 fn 調用都返回一個真值，則使用 true 實現承諾。

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

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

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