TypedArray.prototype.length

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.

lengthTypedArray インスタンスのアクセサープロパティで、型付き配列の長さを(要素数で)返します。

試してみましょう

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer, 2);

console.log(uint8.length);
// Expected output: 6

解説

length プロパティは set アクセサープロパティが undefined であるアクセサープロパティです。これは、このプロパティが読み取り専用であることを意味します。値は TypedArray が構築されたときに確立し、変更することができません。 TypedArraybyteOffset または length が指定されていない場合、参照される ArrayBuffer の長さが返されます。 TypedArray型付き配列オブジェクトのうちの一つです。

length プロパティの使用

js
const buffer = new ArrayBuffer(8);

let uint8 = new Uint8Array(buffer);
uint8.length; // 8 (バッファーの長さと一致)

uint8 = new Uint8Array(buffer, 1, 5);
uint8.length; // 5 (Uint8Array の構築の際に指定された通り)

uint8 = new Uint8Array(buffer, 2);
uint8.length; // 6 (構築された Uint8Array のオフセットによる)

仕様書

Specification
ECMAScript® 2026 Language Specification
# sec-get-%typedarray%.prototype.length

ブラウザーの互換性

関連情報