TypedArray.prototype.indexOf()

indexOf() メソッドは、指定された要素が型付き配列内で見つかった最初の添字を返し、存在しなければ -1 を返します。このメソッドは Array.prototype.indexOf() と同じアルゴリズムです。 TypedArray は、ここでは型付き配列型のうちの一つです。

試してみましょう

構文

js

indexOf(searchElement)
indexOf(searchElement, fromIndex)

引数

searchElement

型付き配列内を検索する要素。

fromIndex 省略可

検索開始位置の添字。添字が型付き配列の長さ以上なら、 -1 が返り、これは型付き配列が検索されなかったことを意味します。与えられた添字が負の数の場合、型付き配列の最後からのオフセット値として扱われます。注意: 指定された添字が負の数であっても、型付き配列は前から後ろに向けて検索されます。計算された添字が 0 未満になった場合は、型付き配列の全体が検索されます。既定値: 0 (型付き配列全体が検索されます)。

返値

配列内の要素の最初の添字です。見つからなかったら -1 になります。

解説

indexOfsearchElement と型付き配列の要素を、厳密等価 (===、イコール 3 つの演算子と同じ方法) を使用して比較します。

indexOf の使用

js

const uint8 = new Uint8Array([2, 5, 9]);
uint8.indexOf(2); // 0
uint8.indexOf(7); // -1
uint8.indexOf(9, 2); // 2
uint8.indexOf(2, -1); // -1
uint8.indexOf(2, -3); // 0

仕様書

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.indexof

ブラウザーの互換性

BCD tables only load in the browser

関連情報