この記事は編集レビューを必要としています。ぜひご協力ください。
この翻訳は不完全です。英語から この記事を翻訳 してください。
これは Harmony(ECMAScript 6) 提案の一部であり、実験段階の技術です。
この技術の仕様は安定していません。ブラウザ互換性の一覧表を確認してください。またこれらの構文や動作は、仕様変更などにより、新しいバージョンのブラウザでは変更される可能性があるという点に注意してください。
概要
要素は、与えられたテスト関数を満たした場合、typed arrayのvalueを返します。さもなければ、undefined
が返されます。TypedArrayはここではtyped array typesの一つです。
findIndex()
メソッドも確かめて下さい。そのメソッドは値のかわりにtyped arrayの見つかった要素のindexを返します。
構文
typedarray.find(callback[, thisArg])
引数
callback
- typed array内の各要素上で実行する関数。三つの引数を持ちます。:
element
- typed array内で処理されている現在の要素
index
- typed array内で処理されている現在のインデックス
array
find
が呼び出されたarray
thisArg
- オプション。
callback
を実行するときthis
として使用するオブジェクト。
説明
find
メソッドはcallback
関数がtrue値を返す要素を見つけるまでtyped array 内に存在している各要素に対して一度callback
関数を実行します。そのような要素が見つかったら、find
はすぐに要素の値を返します。さもなければ、find
はundefined
を返します。callback
は値を割り当てたtyped array内のインデックスに対してのみ呼び出されます。削除されたり決して割り当てていないインデックスに対しては呼び出されません。
callback
は三つの引数で呼び出されます。: 要素の値、要素のインデックス、処理されるtyped arrayオブジェクト。
thisArg
引数がfind
に渡されたら、 callback
の各呼び出しに対してthis
として使用されます。渡されない場合、undefined
が使用されます。
find
は呼び出されているtyped arrayを変更しません。
find
によって処理される要素の範囲はcallback
の最初の呼び出し前に設定されます。find
の呼び出しが始まったあとでtyped array に追加された要素はcallback
によって処理されません。存在していて処理されていないtyped arrayの要素がcallback
によって変更されたら、処理されているcallback
に渡される値は、find
が要素を処理する直前の値です。
例
例: typed array内の素数を探す
次の例では、素数であるtyped array内の要素を探します(または、素数でない場合、undefined
を返します)。
function isPrime(element, index, array) { var start = 2; while (start <= Math.sqrt(element)) { if (element % start++ < 1) { return false; } } return element > 1; } var uint8 = new Uint8Array([4, 5, 8, 12]); console.log(uint8.find(isPrime)); // 5
仕様
仕様 | ステータス | コメント |
---|---|---|
ECMAScript 6 (ECMA-262) The definition of '%TypedArray%.prototype.find' in that specification. |
勧告候補 | 初期定義。 |
ブラウザ実装状況
機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
基本サポート | 未サポート | 37.0 (37.0) | 未サポート | 未サポート | 未サポート |
機能 | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
基本サポート | 未サポート | 未サポート | 37.0 (37.0) | 未サポート | 未サポート | 未サポート |