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

begin から end までのバイト単位のこの ArrayBuffer の内容がコピーされた新しい ArrayBuffer を返します。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