【JavaScript ECMAScript】Array::Array.prototype.everyインスタンスメソッドの使い方
Array.prototype.every()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Array.prototype.every()メソッドは、配列のすべての要素が、指定されたテスト関数によって提供される条件をすべて満たすかどうかをテストし、その結果を真偽値（trueまたはfalse）で返すメソッドです。このメソッドは、引数としてコールバック関数を受け取ります。このコールバック関数は、配列内の各要素に対して一度ずつ実行され、現在の要素の値、そのインデックス、およびevery()メソッドが呼び出された元の配列の3つの引数を受け取ることができます。
every()メソッドの主要な動作として、コールバック関数が配列内のいずれかの要素に対してfalseを返した時点で、即座に反復処理を中止し、falseを返します。言い換えれば、もし一つでも条件を満たさない要素があれば、全体がfalseと判断されます。逆に、コールバック関数が配列のすべての要素に対してtrueを返した場合にのみ、every()メソッドはtrueを返します。これにより、「配列のすべての項目が、特定の基準やルールを満たしているか」といった確認を効率的に行うことができます。
このメソッドは元の配列を直接変更（ミューテート）することはありません。また、空の配列に対してevery()メソッドが呼び出された場合、条件を満たさない要素が存在しないため、常にtrueを返します。コールバック関数内でthisの値を指定したい場合は、every()メソッドの第二引数としてその値を渡すことも可能で、特定のオブジェクトのコンテキストで条件を評価する際に便利です。
構文(syntax)
1[].every((element, index, array) => { 2 return true; 3});
引数(parameters)
callbackFn, thisArg
- callbackFn: (element, index, array) => boolean: 配列の各要素に対して実行されるコールバック関数。要素が条件を満たす場合に
true、そうでない場合にfalseを返します。elementは現在の要素、indexは現在の要素のインデックス、arrayはeveryが呼び出された配列です。 - thisArg: any:
callbackFnが実行される際にthisとして使用される値。
戻り値(return)
boolean
指定された条件に基づいて、JavaScript の Array.prototype.every() メソッドの戻り値の説明を生成します。
Array.prototype.every() メソッドは、配列のすべての要素が、指定されたテスト関数によって実装された条件を満たす場合に true を返します。一つでも条件を満たさない要素があれば false を返します。