Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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 Juli 2015.
DiebyteLength Zugriffs- Eigenschaft vonTypedArray Instanzen gibt die Länge (in Bytes) dieses typisierten Arrays zurück.
Probieren Sie es aus
// Create an ArrayBuffer with a size in bytesconst buffer = new ArrayBuffer(8);const uint8 = new Uint8Array(buffer, 2);console.log(uint8.byteLength);// Expected output: 6Beschreibung
DiebyteLength-Eigenschaft ist eine Zugriffs-Eigenschaft, deren Set-Accessor-Funktionundefined ist, was bedeutet, dass Sie diese Eigenschaft nur lesen können. Wenn das typisierte Arraylängenüberwachend ist, hängt seine Länge von der Länge des zugrunde liegenden Puffers ab und kann sich ändern, wenn der Puffer in der Größe verändert wird. Andernfalls wird der Wert beim Erstellen des typisierten Arrays festgelegt und kann nicht geändert werden. Unabhängig davon, ob es sich um eine längenüberwachende Darstellung handelt oder nicht, wird diebyteLength zu 0, wenn der zugrunde liegende Puffer so verändert wird, dass der betrachtete Bereich nicht mehr gültig ist.
Beispiele
Verwendung der byteLength-Eigenschaft
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)const buffer2 = new ArrayBuffer(16, { maxByteLength: 32 });const uint8lengthTracking = new Uint8Array(buffer2, 4);uint8lengthTracking.byteLength; // 12 (16 - 4)buffer2.resize(20);uint8lengthTracking.byteLength; // 16 (20 - 4)buffer2.resize(3);uint8lengthTracking.byteLength; // 0 (viewed range is no longer valid)Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-get-%typedarray%.prototype.bytelength |
Browser-Kompatibilität
Siehe auch
- JavaScript typisierte Arrays Leitfaden
TypedArray