Die byteOffset-Zugriffseigenschaft von TypedArray-Instanzen gibt den Offset (in Bytes) dieses typisierten Arrays vom Anfang seines ArrayBuffer oder SharedArrayBuffer zurück.

Beschreibung

Die byteOffset-Eigenschaft ist eine Zugriffseigenschaft, deren set-Zugriffsfunktionswert undefined ist, was bedeutet, dass Sie diese Eigenschaft nur lesen können. Der Wert wird festgelegt, wenn das typisierte Array erstellt wird und kann nicht verändert werden. Der byteOffset wird jedoch 0, wenn der zugrunde liegende Puffer so neu dimensioniert wird, dass der betrachtete Bereich nicht mehr gültig ist.

Beispiele

Verwendung der byteOffset-Eigenschaft

const buffer = new ArrayBuffer(8);

const uint8array1 = new Uint8Array(buffer);
uint8array1.byteOffset; // 0 (no offset specified)

const uint8array2 = new Uint8Array(buffer, 3);
uint8array2.byteOffset; // 3 (as specified when constructing Uint8Array)

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• JavaScript typisierte Arrays Leitfaden
• TypedArray