Core JavaScript 1.5 Reference:Global Objects:Array:every
出典: MDC
目次 |
[編集] 概要
与えられた関数によって実行されるテストに配列のすべての要素が合格するかどうかをテストします。
| Array のメソッド | |
| 実装されたバージョン: | JavaScript 1.6 (Gecko 1.8b2 以降) |
| ECMAScript バージョン: | なし |
[編集] 構文
var allPassed = array.every(callback[, thisObject]);
[編集] パラメータ
-
callback - 各要素に対してテストを実行する関数。
-
thisObject -
callbackを実行するときにthisとして使用するオブジェクト。
[編集] 説明
every は、与えられた callback 関数を、配列に含まれる各要素に対して一度ずつ、callback が偽の値を返す要素が見つかるまで呼び出します。 偽の値を返す要素が見つかると、every メソッドはただちに false を返します。 そうならなかった場合、すなわち callback がすべての要素に対して真の値を返した場合、every は true を返します。 callback は値が代入されている配列のインデックスに対してのみ呼び出されます。つまり、すでに削除されたインデックスや、まだ値が代入されていないインデックスに対しては呼び出されません。
callback は、要素の値、要素のインデックス、走査されている Array オブジェクトという 3 つの引数をともなって呼び出されます。
every に thisObject パラメータが与えられると、callback の呼び出しのたびにそのオブジェクトが this として使用されます。thisObject が与えられないか null だと、callback に結び付けられたグローバルオブジェクトが代わりに使用されます。
every は呼び出された配列を変化させません。
every によって処理される要素の範囲は、callback が最初に呼び出される前に設定されます。every の呼び出しが開始された後に追加された要素に対しては、callback は実行されません。既存の配列要素が変更されたり、削除された場合、callback に渡される値は every がそれらを訪れた時点での値になり、削除された要素には訪問されません。
every は、数学において「すべての (for all) 」を表す記号と同様のふるまいをします。具体的に言うと、every は空の配列に対しては true を返します。(空集合のすべての要素が与えられた任意の条件を満たすことは空虚に真 (vacuously true) です。)
[編集] 互換性
every は ECMA-262 標準に対する JavaScript 拡張なので、ECMA-262 標準の他の実装では存在しない場合があります。次のコードをスクリプトの先頭に挿入すると、every がネイティブでサポートされていない ECMA-262 実装でも every を使用できるようになります。これは Firefox および SpiderMonkey で使われているアルゴリズムとまったく同じものです。
if (!Array.prototype.every)
{
Array.prototype.every = function(fun /*, thisp*/)
{
var len = this.length;
if (typeof fun != "function")
throw new TypeError();
var thisp = arguments[1];
for (var i = 0; i < len; i++)
{
if (i in this &&
!fun.call(thisp, this[i], i, this))
return false;
}
return true;
};
}
[編集] 例
[編集] 例: 配列のすべての要素の大きさをテストする
次の例は、配列内のすべての要素が 10 よりも大きいかどうかテストします。
function isBigEnough(element, index, array) {
return (element >= 10);
}
var passed = [12, 5, 8, 130, 44].every(isBigEnough);
// passed は false
passed = [12, 54, 18, 130, 44].every(isBigEnough);
// passed は true