ArrayBuffer() コンストラクター

ArrayBuffer() コンストラクターは ArrayBuffer オブジェクトを生成するために使用されます。

構文

new ArrayBuffer(length)

引数

length
作成する配列バッファーのサイズをバイト単位で指定します。

返値

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

例外

RangeError: lengthNumber.MAX_SAFE_INTEGER よりも大きい (>= 2 ** 53) か、負の値であった場合。

互換性の注意

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);

ArrayBuffer の作成

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

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

仕様書

仕様書
ECMAScript (ECMA-262)
ArrayBuffer の定義

ブラウザーの互換性

BCD tables only load in the browser

関連情報