Iterator.prototype.every()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

every()Iterator インスタンスのメソッドで、 Array.prototype.every() と似ています。このイテレーターによって生成されたすべての要素が、指定された関数によって実装された試験に合格するかどうかを確認します。論理値を返します。

構文

js
every(callbackFn)

引数

callbackFn

このイテレーターによって生成された各要素に対して実行する関数。要素が試験に合格したことを示す真値、またはそうでなければ偽値を返さなければなりません。この関数は、以下の引数とともに呼び出されます。

element

処理中の現在の要素です。

index

処理中の現在の要素のインデックスです。

返値

callbackFn がすべての要素に対して真値を返した場合は true です。そうでなければ false です。

解説

every() はイテレーターを反復処理し、各要素に対して一度ずつ callbackFn 関数を呼び出します。 コールバック関数が偽値を返した場合は、ただちに false を返します。そうでない場合は、イテレーターの最後まで反復処理を行い、 true を返します。 every()false を返した場合、そのイテレーターの return() メソッドを呼び出して終了します。

イテレーターヘルパーの主な利点は、配列メソッドよりも「遅延的」であるということです。つまり、要求されたときにのみ次の値を生成するという意味です。これにより、不必要なコンピューター処理を避けることができ、また無限イテレーターでも使用することができます。無限イテレーターでは、every() は最初の偽値が得られるとすぐに false を返します。もし callbackFn が常に真値を返した場合、メソッドは終了しません。

every() の使用

js
function* fibonacci() {
  let current = 1;
  let next = 1;
  while (true) {
    yield current;
    [current, next] = [next, current + next];
  }
}

const isEven = (x) => x % 2 === 0;
console.log(fibonacci().every(isEven)); // false

const isPositive = (x) => x > 0;
console.log(fibonacci().take(10).every(isPositive)); // true
console.log(fibonacci().every(isPositive)); // Never completes

every() を呼び出すと、メソッドが早期に終了した場合でも、常にその元となるイテレーターが閉じられます。 イテレーターが未完了の状態で残されることはありません。

js
const seq = fibonacci();
console.log(seq.every(isEven)); // false
console.log(seq.next()); // { value: undefined, done: true }

仕様書

Specification
Iterator Helpers
# sec-iteratorprototype.every

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
every

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.
Has more compatibility info.

関連情報