このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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 ⁨2015年7月⁩.

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

ブラウザーの互換性

関連情報