JavaScript/ArrayBuffer
ArrayBuffer
概要
ArrayBuffer
は、生のバイナリデータを表す固定長の生バイトバッファを定義するJavaScriptのオブジェクトです。これは、低レベルのバイナリデータ操作を可能にする、型付き配列とデータビューの基礎となるオブジェクトです。
コンストラクタ
ArrayBuffer()
new ArrayBuffer(length)
- 引数
length
: バッファのサイズ(バイト単位)を指定する非負の整数
- 戻り値:指定されたサイズの新しい空の
ArrayBuffer
オブジェクト
静的メソッド
ArrayBuffer.isView()
ArrayBuffer.isView(arg)
- 引数
arg
: 確認するオブジェクト
- 戻り値:型付き配列または
DataView
であればtrue
、そうでない場合はfalse
ArrayBuffer.transfer()
ArrayBuffer.transfer(oldBuffer[, newByteLength])
- 引数
oldBuffer
: 転送元のArrayBuffer
newByteLength
(オプション):新しいバッファのバイト長
- 戻り値:新しい
ArrayBuffer
- 説明:元のバッファから新しいバッファへデータを効率的に転送する
プロパティ
ArrayBuffer.prototype.byteLength
- 読み取り専用プロパティ
- バッファのバイト長を返す
メソッド
ArrayBuffer.prototype.slice()
arrayBuffer.slice(start[, end])
- 引数
start
:開始バイトインデックスend
(オプション):終了バイトインデックス
- 戻り値:元のバッファの指定された部分を含む新しい
ArrayBuffer
使用例
// ArrayBufferの作成 const buffer = new ArrayBuffer(16); // 型付き配列での使用 const int32View = new Int32Array(buffer); int32View[0] = 42; // DataViewでのバイト単位操作 const dataView = new DataView(buffer); dataView.setInt16(0, 0x1234, true);
注意点
ArrayBuffer
は直接操作できず、型付き配列やDataView
を通じてアクセスする- メモリ効率が高く、バイナリデータの低レベル操作に適している
- WebGL、ファイル操作、ネットワークバッファなど、様々な用途で使用される
関連オブジェクト
ブラウザサポート
Internet Explorer 10+- Chrome 7+
- Firefox 4+
- Safari 5.1+
- Edge 12+
仕様
- ECMAScript 2015 (ES6)