ArrayBuffer

ArrayBuffer は、一般的な固定長のバイナリーデータのバッファを示すために使われるデータタイプです。ArrayBuffer の内容を直接操作することはできません。代わりにバッファを特定の形式で表現し、またバッファの内容物を読み書きするために使用される typed array object か DataView オブジェクトを作成します。

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

構文

new ArrayBuffer(length)

引数

length

ArrayBuffer を生成するためのバイト単位のサイズ。

戻り値

指定したサイズの新しい ArrayBuffer オブジェクト。内容物は 0 に初期化される。

例外

length が Number.MAX_SAFE_INTEGER (>= 2 ** 53) より大きい場合、または負の数値の場合、RangeError が発生します。

説明

ArrayBuffer コンストラクターは、与えられたバイト単位の長さの新しい ArrayBuffer を生成します。

既存のデータから ArrayBuffer を取得する

• Base64 文字列から
• ローカルファイルから

プロパティ

ArrayBuffer.length

ArrayBuffer コンストラクターの length プロパティの値は 1 です。

get ArrayBuffer[@@species]

派生オブジェクトを生成するために使用されるコンストラクター関数です。

ArrayBuffer.prototype

すべての ArrayBuffer オブジェクトへのプロパティに追加できます。

メソッド

ArrayBuffer.isView(arg)

arg が TypedArray オブジェクト か DataView のいずれかのような ArrayBuffer ビューの場合は true を、そうでなければ false を返します。

ArrayBuffer.transfer(oldBuffer [, newByteLength])

内容が oldBuffer のデータから取られて、newByteLength によって切り捨てられるか、ゼロ拡張された新しい ArrayBuffer を返します。

インスタンス

すべての ArrayBuffer インスタンスは ArrayBuffer.prototype を継承します。

プロパティ

ArrayBuffer.prototype.constructor

オブジェクトのプロトタイプを生成する関数を指定します。既定値は標準で組み込まれた ArrayBuffer コンストラクターです。

ArrayBuffer.prototype.byteLength 読取専用

配列のバイト単位の大きさです。これは、配列が構築されるときに設定され、変更されません。読み取り専用です。

メソッド

ArrayBuffer.prototype.slice()

新しい ArrayBuffer を返し、これにはこの ArrayBuffer の begin から end の手前までのバイト単位の内容がコピーされます。 begin または end のどちらかが負の数の場合、これは配列の先頭からではなく、末尾からのインデックスを表します。

ArrayBuffer.slice()

ArrayBuffer.prototype.slice() と同じ機能を持ちます。

例

この例では、バッファを参照する Int32Array ビューで 8 バイトのバッファを生成しています:

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

仕様

ブラウザー実装状況

互換に関する注記

ECMAScript 2015 から、ArrayBuffer コンストラクターは new 演算子を必要とするようになりました。new なしで関数として ArrayBuffer コンストラクターを呼び出すと、TypeError をスローするようになっています。

var dv = ArrayBuffer(10);
// TypeError: calling a builtin ArrayBuffer constructor 
// without new is forbidden

var dv = new ArrayBuffer(10);

関連項目

• JavaScript typed arrays
• SharedArrayBuffer