【JavaScript ECMAScript】TypedArray::TypedArray.prototype.someインスタンスメソッドの使い方
TypedArray.prototype.some()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
TypedArray.prototype.some()メソッドは、TypedArrayオブジェクトの要素のうち、少なくとも1つが指定されたテスト関数によって提供される条件を満たすかどうかを確認するメソッドです。このメソッドは、配列内に特定の条件を満たす要素が存在するかどうかを素早く判定したい場合に利用されます。
some()メソッドは、各要素に対して一度ずつ実行されるコールバック関数を引数として受け取ります。このコールバック関数は、現在の要素の値、そのインデックス、そしてメソッドが呼び出されたTypedArray自体を引数に取ることができます。コールバック関数が任意の要素に対してtrueを返した場合、some()メソッドは直ちにtrueを返し、残りの要素のチェックは行いません。もし全ての要素に対してコールバック関数が実行され、一度もtrueが返されなかった場合にのみ、some()メソッドはfalseを返します。
このメソッドは、元のTypedArrayの内容を変更することはありません。また、コールバック関数内でthisとして使用する値を、some()メソッドの第二引数として任意で指定することも可能です。配列内に特定の基準を満たす要素が一つでも存在するかを効率的に判定する目的で活用されます。
公式リファレンス: TypedArray.prototype.some()
構文(syntax)
1const typedArray = new Uint8Array([1, 2, 3, 4, 5]); 2 3typedArray.some(function(element, index, array) { 4 return element > 3; 5});
引数(parameters)
callbackFn, thisArg
- callbackFn: (element, index, array) => boolean: 配列の各要素に対して実行されるコールバック関数。
elementは現在の要素、indexは現在の要素のインデックス、arrayはsomeメソッドが呼び出された配列です。この関数がtrueを返すと、someメソッドはtrueを返して処理を終了します。 - thisArg: any:
callbackFnを実行する際にthisとして使用される値。
戻り値(return)
boolean
TypedArray.prototype.some() メソッドは、配列のいずれかの要素が指定されたテスト関数を満たす場合に true を返します。すべての要素がテスト関数を満たさない場合は false を返します。