TypedArray.prototype.every()

概要

typed array内のすべての要素が提供された関数によって実装されたテストを渡すかどうかテストします。このメソッドはArray.prototype.every()と同じアルゴリズムです。TypedArrayはtyped array typesの一つです、

構文

typedarray.every(callback[, thisArg])

引数

callback

各要素に対してテストする関数。三つの引数があります。:

currentValue

typed array内で処理されている現在の要素

index

typed array内で処理されている現在の要素のインデックス。

array

everyが呼ばれたtyped array

thisArg

任意。callbackを実行するときにthisとして使用する値。

説明

everyメソッドは、callback関数がfalsy(Booleanに変換されたらfalseになる値)を返す要素が見つかるまでtyped array内に存在する各要素に対して一度提供されたcallback関数を実行します。そのような要素が見つかったら、everyメソッドはすぐにfalseを返します。さもなければ、callbackがすべての要素に対してtrueを返したら、everyはtrueを返します。

callbackは三つの引数で呼び出されます。: 要素の値、要素のインデックス、処理される配列オブジェクト

thisArg 引数がeveryに渡されたら、呼び出されたときに、this値として使用するためにcallbackに渡されます。さもなければ、 undefined値がthis値として使用されるために渡されます。callbackによって最終的に観察可能なthis 値はthe usual rules for determining the this seen by a functionに応じて決定されます。

everyは呼ばれるtyped arrayを変化させません。

例

すべてのtyped arrayの要素のサイズをテストする

次の例では、typed array内のすべての要素が10より大きいかテストします。

function isBigEnough(element, index, array) {
  return element >= 10;
}
new Uint8Array([12, 5, 8, 130, 44]).every(isBigEnough);   // false
new Uint8Array([12, 54, 18, 130, 44]).every(isBigEnough); // true

arrow functionsを使用してtyped arrayの要素をテストする。

Arrow functions は、同じテストのための短い構文を提供します。

new Uint8Array([12, 5, 8, 130, 44]).every(elem => elem >= 10); // false
new Uint8Array([12, 54, 18, 130, 44]).every(elem => elem >= 10); // true

仕様

ブラウザ実装状況

関連情報

• TypedArray.prototype.some()
• Array.prototype.every()