ArrayBuffer

ArrayBuffer オブジェクトは、一般的な固定長の生のバイナリーデータバッファーを表現するために使用します。

ArrayBuffer はバイトの配列で、他の言語ではよく「バイト配列」と呼ばれます。ArrayBuffer の内容を直接操作することはできません。代わりに、バッファーを特定の形式で表現する型付き配列オブジェクトまたは DataView オブジェクトのいずれかを作成して、バッファーの内容を読み書きします。

ArrayBuffer() コンストラクターは、指定した長さの ArrayBuffer をバイト単位で作成します。既存のデータから、たとえば、Base64 文字列やローカルファイルからから配列バッファーを取得することもできます。

コンストラクター

ArrayBuffer(): 新しい ArrayBuffer オブジェクトを作成します。

静的プロパティ

get ArrayBuffer[@@species]: 派生オブジェクトを作成する際に使用するコンストラクター関数です。

静的メソッド

ArrayBuffer.isView(arg): arg が型付き配列オブジェクトや DataView のような ArrayBuffer ビューのいずれかである場合は true を返します。それ以外の場合は false を返します。

インスタンスプロパティ

ArrayBuffer.prototype.byteLength: ArrayBuffer の長さ (バイト単位) で、読み取り専用です。これは配列が構築されたときに設定され、変更することはできません。

インスタンスメソッド

ArrayBuffer.prototype.slice(): 新しい ArrayBuffer に、begin (の位置) から end (の手前) までのバイトのコピーを入れて返します。begin または end のどちらかが負の値の場合は、配列の先頭からではなく、配列の末尾からの位置を指します。

例

ArrayBuffer の作成

この例では、バッファーを参照する Int32Array ビューを持つ 8 バイトバッファーを作成します。

const buffer = new ArrayBuffer(8);
const view = new Int32Array(buffer);

仕様書

Specification
ECMAScript Language Specification # sec-arraybuffer-objects

ブラウザーの互換性

BCD tables only load in the browser