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 Juli 2015.
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
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-get-%typedarray%.prototype.byteoffset |
Browser-Kompatibilität
Loading…
Siehe auch
- JavaScript typisierte Arrays Leitfaden
TypedArray