CKTIS / JavaScript
TypedArray.byteLength — Länge der Ansicht in Bytes
Die Eigenschaft byteLength gibt an, wie viele Bytes eine typisierte Array-Ansicht umfasst, nicht wie viele Elemente sie enthält oder wie groß ihr gesamter Puffer ist. Sie wird an einer Instanz ausgelesen und hat keinen Setter.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
typedArray.byteLengthTypedArray.byteLength bezeichnet hier die Instanzeigenschaft, die formal TypedArray.prototype.byteLength heißt. Lies sie als typedArray.byteLength aus, ohne Klammern. TypedArray ist kein globaler Konstruktor; verwende einen konkreten Typ wie Uint16Array. Die Eigenschaft hat keinen Setter: Eine Zuweisung an sie ändert die Größe der Ansicht nicht.
length zählt Elemente, während byteLength Bytes zählt: typedArray.byteLength === typedArray.length * typedArray.BYTES_PER_ELEMENT. Dagegen beschreibt typedArray.buffer.byteLength den gesamten Puffer, und byteOffset gibt den Anfang der Ansicht in Bytes an. Eine Ansicht kann nur einen Teil eines Puffers umfassen; ihr byteLength ist kein Maß für den gesamten Speicherverbrauch des Objekts.
Bei einem größenveränderlichen Puffer kann sich byteLength einer längenverfolgenden Ansicht ändern. Eine Ansicht mit fester Länge wird nicht zusammen mit dem Puffer erweitert. Wird der Puffer so verkleinert, dass der Bereich der Ansicht ungültig wird, beträgt byteLength 0.
Die grundlegende Eigenschaft ist seit Juli 2015 in Browsern weit verbreitet; die Unterstützung für größenveränderliche Puffer muss separat geprüft werden. Im Beispiel steht das dritte Argument von Uint16Array für 3 Elemente, nicht für 3 Bytes: Die Ansicht umfasst 6 Bytes innerhalb eines 16-Byte-Puffers.
Beispiele
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log(view.length);
console.log(view.BYTES_PER_ELEMENT);
console.log(view.byteLength);
console.log(view.byteOffset);
console.log(view.buffer.byteLength);Ergebnis
3 2 6 4 16
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.