TypedArray.prototype.includes()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
includes()
は TypedArray
インスタンスのメソッドで、型付き配列の項目内に特定の値が含まれているかどうかを判断し、その結果に応じて true
か false
を返します。このメソッドは Array.prototype.includes()
と同じアルゴリズムです。
試してみましょう
構文
js
includes(searchElement)
includes(searchElement, fromIndex)
引数
searchElement
-
探す対象の要素
fromIndex
省略可-
検索を始める位置を示すゼロ基点のインデックスで、整数に変換されます。
返値
論理値で、型付き配列(指定する場合はインデックス fromIndex
で示される型付き配列の一部)内で値 searchElement
が見つかった場合に true
なります。
解説
詳細については、 Array.prototype.includes()
をご覧ください。このメソッドは汎用的ではなく、型付き配列インスタンスに対してのみ呼び出すことができます。
例
includes の使用
js
const uint8 = new Uint8Array([1, 2, 3]);
uint8.includes(2); // true
uint8.includes(4); // false
uint8.includes(3, 3); // false
// NaN の扱い (Float32 および Float64 に限り true)
new Uint8Array([NaN]).includes(NaN); // false (コンストラクターに渡した NaN は 0 に変換されるため)
new Float32Array([NaN]).includes(NaN); // true;
new Float64Array([NaN]).includes(NaN); // true;
仕様書
Specification |
---|
ECMAScript Language Specification # sec-%typedarray%.prototype.includes |
ブラウザーの互換性
BCD tables only load in the browser