DataView.prototype.byteOffset

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

DataView 例項的 byteOffset 訪問器屬性返回此檢視相對於其 ArrayBufferSharedArrayBuffer 起始位置的偏移量(以位元組為單位)。

試一試

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);

const view = new DataView(buffer, 12, 4); // From byte 12 for the next 4 bytes

console.log(view.byteOffset);
// Expected output: 12

描述

byteOffset 屬性是一個訪問器屬性,其 set 訪問器函式為 undefined,這意味著您只能讀取此屬性。該值在建立 DataView 時建立,並且無法更改。但是,如果底層緩衝區被重置,導致檢視的範圍不再有效,則 byteOffset 會變為 0。

示例

使用 byteOffset 屬性

js
const buffer = new ArrayBuffer(8);
const dataview = new DataView(buffer);
dataview.byteOffset; // 0 (no offset specified)

const dataview2 = new DataView(buffer, 3);
dataview2.byteOffset; // 3 (as specified when constructing the DataView)

const buffer2 = new ArrayBuffer(16, { maxByteLength: 32 });
const dataviewLengthTracking = new DataView(buffer2, 4);
dataviewLengthTracking.byteOffset; // 4
buffer2.resize(3);
dataviewLengthTracking.byteOffset; // 0 (viewed range is no longer valid)

規範

規範
ECMAScript® 2026 語言規範
# sec-get-dataview.prototype.byteoffset

瀏覽器相容性

另見