【JavaScript ECMAScript】TypedArray::TypedArray.prototype.findIndexインスタンスメソッドの使い方
TypedArray.prototype.findIndex()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
TypedArray.prototype.findIndex()メソッドは、TypedArrayオブジェクトの要素の中から、指定されたテスト関数（コールバック関数）が真（true）を返す最初の要素のインデックス（添字）を検索して返却するメソッドです。このメソッドは、配列のような構造を持つTypedArrayインスタンスに対して呼び出され、各要素を順に処理します。
具体的には、findIndex()メソッドは、TypedArrayの各要素に対して一度ずつ、引数として与えられたテスト関数を実行します。テスト関数は通常、現在の要素の値、その要素のインデックス、そしてfindIndex()が呼び出された元のTypedArrayオブジェクト自体を受け取ります。もしテスト関数が真を返した最初の要素が見つかった場合、その要素のインデックスがfindIndex()メソッドの戻り値となります。
もしTypedArrayの全ての要素をチェックしても、テスト関数が一度も真を返さなかった場合は、-1が返されます。このメソッドは元のTypedArrayを変更することはなく、常に新しい値を見つけてそのインデックスを報告します。例えば、特定の条件を満たす数値がTypedArray内に存在するか、また存在する場合はその位置がどこであるかを知りたい場合に非常に役立ちます。TypedArrayは、JavaScriptで固定長の数値データの配列を扱う際に使用され、Int8ArrayやFloat32Arrayなどがその一例です。
構文(syntax)
1const typedArrayInstance = new Int32Array([10, 20, 30, 40, 50]); 2 3const foundIndex = typedArrayInstance.findIndex((element, index, array) => { 4 return element === 30; // 条件に一致する最初の要素のインデックスを返す 5});
引数(parameters)
callbackFn, thisArg
- callbackFn: (element, index, array) => boolean: 配列の各要素に対して実行されるコールバック関数。要素が条件に合致した場合、trueを返します。
- thisArg: any: callbackFn を実行する際に
thisとして使用される値
戻り値(return)
number
指定された条件に一致する要素の最初のインデックスを返します。一致する要素が見つからない場合は-1を返します。