TypedArray.BYTES_PER_ELEMENT

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

TypedArray.BYTES_PER_ELEMENT プロパティは、型付き配列内の各要素の大きさをバイト単位で表します。

試してみましょう

値

TypedArray の方に応じた値を持つ数値です。

TypedArray.BYTES_PER_ELEMENT のプロパティ属性
書込可能 不可
列挙可能 不可
設定可能 不可

解説

TypedArrayオブジェクトは、要素ごとのバイト数とバイトの解釈の仕方がそれぞれ異なります。BYTES_PER_ELEMENT 定数は、指定された TypedArray の各要素のバイト数を格納します。

BYTES_PER_ELEMENT プロパティはインスタンスプロパティでも静的プロパティでもあります。これは TypedArray サブクラスのコンストラクターとコンストラクターのインスタンスの両方で利用することができます。

インスタンスプロパティとして、BYTES_PER_ELEMENT はコンストラクターの prototype で定義されます。

js
console.log(Object.hasOwn(Int8Array.prototype, "BYTES_PER_ELEMENT")); // true

例

BYTES_PER_ELEMENT の使用

静的プロパティとして

js
Int8Array.BYTES_PER_ELEMENT; // 1
Uint8Array.BYTES_PER_ELEMENT; // 1
Uint8ClampedArray.BYTES_PER_ELEMENT; // 1
Int16Array.BYTES_PER_ELEMENT; // 2
Uint16Array.BYTES_PER_ELEMENT; // 2
Int32Array.BYTES_PER_ELEMENT; // 4
Uint32Array.BYTES_PER_ELEMENT; // 4
Float32Array.BYTES_PER_ELEMENT; // 4
Float64Array.BYTES_PER_ELEMENT; // 8
BigInt64Array.BYTES_PER_ELEMENT; // 8
BigUint64Array.BYTES_PER_ELEMENT; // 8

インスタンスプロパティとして

js
new Int8Array([]).BYTES_PER_ELEMENT; // 1
new Uint8Array([]).BYTES_PER_ELEMENT; // 1
new Uint8ClampedArray([]).BYTES_PER_ELEMENT; // 1
new Int16Array([]).BYTES_PER_ELEMENT; // 2
new Uint16Array([]).BYTES_PER_ELEMENT; // 2
new Int32Array([]).BYTES_PER_ELEMENT; // 4
new Uint32Array([]).BYTES_PER_ELEMENT; // 4
new Float32Array([]).BYTES_PER_ELEMENT; // 4
new Float64Array([]).BYTES_PER_ELEMENT; // 8
new BigInt64Array([]).BYTES_PER_ELEMENT; // 8
new BigUint64Array([]).BYTES_PER_ELEMENT; // 8

仕様書

Specification
ECMAScript Language Specification
# sec-typedarray.bytes_per_element

ブラウザーの互換性

BCD tables only load in the browser

関連情報