【JavaScript ECMAScript】TypedArray::TypedArray.prototype.byteOffsetインスタンスアクセサプロパティの使い方

TypedArray.prototype.byteOffsetプロパティは、TypedArrayオブジェクトが参照するArrayBuffer内のデータの開始位置をバイト単位で保持するプロパティです。

JavaScriptにおけるTypedArrayは、固定長のバイナリデータを効率的に扱うために設計された特別な配列のようなオブジェクトです。これは、数値の配列などをメモリ上で直接管理する際に用いられます。TypedArrayの実際のデータは、ArrayBufferという名前の、生のバイナリデータを保持するための低レベルなバッファに格納されています。

一つのArrayBufferから、異なるデータ型や開始位置を指定して複数のTypedArrayビューを作成することが可能です。例えば、同じArrayBufferの先頭をバイト列（Uint8Array）として扱い、その途中から32ビット整数（Int32Array）として扱う、といった使い方ができます。このとき、byteOffsetプロパティは、現在のTypedArrayインスタンスが、基となるArrayBufferのどの位置（先頭からのバイト数）から自身のデータが開始しているかを示します。

このプロパティは読み取り専用であり、TypedArrayインスタンスが生成された時点で設定されます。これにより、開発者はTypedArrayがArrayBufferのどの範囲のデータを「見ている」のかを正確に把握し、低レベルなデータ操作や、ネットワークから受信したバイナリデータの解析などにおいて、データのメモリ上の位置を精密に管理することができます。

Copy
1const typedArrayInstance = new Uint8Array(16);
2typedArrayInstance.byteOffset;

引数なし

引数はありません

number

TypedArray.prototype.byteOffset は、TypedArray の先頭から、この TypedArray が参照する ArrayBuffer の先頭までのバイト数を返します。