TypedArray.prototype.byteOffset

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

byteOffset はTypedArray インスタンスのアクセサープロパティで、この型付き配列のArrayBuffer またはSharedArrayBuffer の開始位置からの（バイト単位の）オフセットを返します。

解説

byteOffset プロパティは設定アクセサープロパティがundefined であるアクセサープロパティです。これは、このプロパティが読み取り専用であることを意味します。値は型付き配列が構築された時点で確定し、変更できません。ただし、基盤となるバッファーのサイズ変更により表示範囲が有効できなくなった場合、byteOffset は 0 になります。

例

byteOffset プロパティの使用

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; // 4buffer2.resize(3);uint8lengthTracking.byteOffset; // 0 （ビュー範囲が有効ではなくなった）