TypedArray.prototype.byteLength
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.
byteLength
は TypedArray
のアクセサープロパティで、この型付き配列の長さを(バイト単位で)返します。
試してみましょう
解説
byteLength
プロパティは設定アクセサープロパティが undefined
である、読み取り専用のアクセサープロパティです。値は TypedArray が構築されたときに確立し、変更することができません。 TypedArray が byteOffset
や length
を指定していないなら、参照されている ArrayBuffer
の length
が返されます。 TypedArray は型付き配列オブジェクトのうちの一つです。
例
byteLength プロパティの使用
js
const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);
uint8.byteLength; // 8 (matches the byteLength of the buffer)
const uint8newLength = new Uint8Array(buffer, 1, 5);
uint8newLength.byteLength; // 5 (as specified when constructing the Uint8Array)
const uint8offSet = new Uint8Array(buffer, 2);
uint8offSet.byteLength; // 6 (due to the offset of the constructed Uint8Array)
仕様書
Specification |
---|
ECMAScript Language Specification # sec-get-%typedarray%.prototype.bytelength |
ブラウザーの互換性
BCD tables only load in the browser