TypedArray.prototype.byteOffset
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
byteOffset は TypedArray インスタンスのアクセサープロパティで、この型付き配列の ArrayBuffer または SharedArrayBuffer の開始位置からの（バイト単位の）オフセットを返します。
解説
byteOffset プロパティは設定アクセサープロパティが undefined であるアクセサープロパティです。これは、このプロパティが読み取り専用であることを意味します。値は型付き配列が構築された時点で確定し、変更できません。ただし、基盤となるバッファーのサイズ変更により表示範囲が有効できなくなった場合、byteOffset は 0 になります。
例
byteOffset プロパティの使用
js
const buffer = new ArrayBuffer(8);
const uint8array1 = new Uint8Array(buffer);
uint8array1.byteOffset; // 0 （オフセットを指定していない）
const uint8array2 = new Uint8Array(buffer, 3);
uint8array2.byteOffset; // 3 （Uint8Array の構築時に指定したとおり）
const buffer2 = new ArrayBuffer(16, { maxByteLength: 32 });
const uint8lengthTracking = new Uint8Array(buffer2, 4);
uint8lengthTracking.byteOffset; // 4
buffer2.resize(3);
uint8lengthTracking.byteOffset; // 0 （ビュー範囲が有効ではなくなった）
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-get-%typedarray%.prototype.byteoffset |