TypedArray.prototype.includes()
BaselineWidely 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()
と同じアルゴリズムです。
試してみましょう
const uint8 = new Uint8Array([10, 20, 30, 40, 50]);console.log(uint8.includes(20));// Expected output: true// Check from position 3console.log(uint8.includes(20, 3));// Expected output: false
構文
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); // trueuint8.includes(4); // falseuint8.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® 2026 Language Specification # sec-%typedarray%.prototype.includes |