TypedArray.prototype.length

Baseline Weitgehend verfgbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit Juli 2015 browserbergreifend verfgbar.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Die length Zugriffs-Eigenschaft von TypedArray Instanzen gibt die Lnge (in Elementen) dieses typisierten Arrays zurck.

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.length);
// Expected output: 6

Die length-Eigenschaft ist eine Zugriffs-Eigenschaft, deren Set-Accessor-Funktion undefined ist, was bedeutet, dass Sie diese Eigenschaft nur lesen knnen. Wenn das typisierte Array lngenverfolgend ist, dann hngt seine Lnge von der Lnge des zugrunde liegenden Puffers ab und kann sich ndern, wenn der Puffer neu dimensioniert wird. Andernfalls wird der Wert beim Konstruktion des typisierten Arrays festgelegt und kann nicht gendert werden. Unabhngig davon, ob es lngenverfolgend ist oder nicht, wird die length zu 0, wenn der zugrunde liegende Puffer so neu dimensioniert wird, dass der betrachtete Bereich nicht mehr gltig ist.

Beispiele

Verwendung der length-Eigenschaft

const buffer = new ArrayBuffer(8);

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

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

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

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