TypedArray.prototype.byteLength

Baseline Widely available

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

Die byteLength Zugriffs-Eigenschaft von TypedArray Instanzen gibt die Länge (in Bytes) dieses typisierten Arrays zurück.

Probieren Sie es aus

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer, 2);

console.log(uint8.byteLength);
// Expected output: 6

Beschreibung

Die byteLength Eigenschaft ist eine Zugriffs-Eigenschaft, deren set-Zugriffsfunktion undefined ist, was bedeutet, dass Sie diese Eigenschaft nur lesen können. Der Wert wird beim Erstellen eines TypedArray festgelegt und kann nicht geändert werden. Wenn das TypedArray keinen byteOffset oder eine length angibt, wird die length des referenzierten ArrayBuffer zurückgegeben. TypedArray ist eines der TypedArray-Objekte.

Beispiele

Verwendung der byteLength-Eigenschaft

js
const buffer = new ArrayBuffer(8);

const uint8 = new Uint8Array(buffer);
uint8.byteLength; // 8 (matches the byteLength of the buffer)

const uint8newLength = new Uint8Array(buffer, 1, 5);
uint8newLength.byteLength; // 5 (as specified when constructing the Uint8Array)

const uint8offSet = new Uint8Array(buffer, 2);
uint8offSet.byteLength; // 6 (due to the offset of the constructed Uint8Array)

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-get-%typedarray%.prototype.bytelength

Browser-Kompatibilität

Siehe auch