CKTIS / JavaScript
TypedArray: Puffer, Byte-Offset, Byte-Länge und Elementanzahl
Unterscheide den gesamten Puffer vom Bytebereich und der Elementanzahl einer Ansicht. Erfahre, was die Getter nach einer Größenänderung oder dem Ablösen des Puffers liefern.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
view.buffer
view.byteOffset
view.byteLength
view.length
new Uint16Array(buffer)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Eine Instanz wie Uint16Array ist eine Ansicht auf einen Puffer. TypedArray bezeichnet die Typfamilie; es gibt keinen globalen Konstruktor dieses Namens, den man direkt aufrufen kann. Die vier Eigenschaften sind geerbte Getter ohne Setter. Wird einer davon für ein Objekt aufgerufen, das kein typisiertes Array ist, löst er TypeError aus. view.length ist nicht Uint16Array.length, die deklarierte Parameteranzahl des Konstruktors.
view.buffer liefert dasselbe zugrunde liegende ArrayBuffer- oder SharedArrayBuffer-Objekt, keine Kopie. view.byteOffset gibt den Abstand vom Pufferanfang an und view.byteLength die Größe der Ansicht, jeweils in Bytes. view.length zählt Elemente. Beziehen sich beide Lesezugriffe auf dieselbe Ansichtsgröße, gilt view.byteLength === view.length * view.BYTES_PER_ELEMENT. Die Getter werden getrennt aufgerufen: Vergrößert ein anderer Agent den zugrunde liegenden SharedArrayBuffer zwischen den Zugriffen, können die Getter einer Ansicht mit dynamischer Länge unterschiedliche Größen erfassen und der Vergleich kann false ergeben. view.buffer.byteLength misst den gesamten Puffer, nicht nur die Ansicht.
In new Uint16Array(buffer, byteOffset, length) steht das zweite Argument für Bytes und das dritte für Elemente. Ein nicht an der Elementgröße ausgerichteter Offset oder ein Bereich außerhalb des Puffers löst RangeError aus. Schreibzugriffe sind in überlappenden Ansichten auf denselben Puffer sichtbar. Die Weitergabe einer Ansicht verbirgt die übrigen Bytes nicht: Kopiere die Bytes eines gültigen Bereichs in einen separaten Puffer, wenn nur dieser Bereich offengelegt werden soll.
Bei einem Puffer fester Größe umfasst die Ansicht ohne length den Rest, in den eine ganze Anzahl von Elementen passen muss. Bei einem größenveränderlichen ArrayBuffer oder einem vergrößerbaren SharedArrayBuffer passt sich die Länge an, wenn length fehlt oder undefined ist: Die Ansicht zählt die vollständigen Elemente ab ihrem Offset. Eine explizite Elementanzahl legt die Länge fest.
Durch Verkleinern kann eine Ansicht außerhalb der Puffergrenzen geraten; durch erneutes Vergrößern kann sie wieder hineinpassen. Liegt sie außerhalb oder wurde ihr ArrayBuffer abgelöst (etwa durch eine Übertragung), liefern alle drei numerischen Getter 0, doch buffer liefert weiterhin dasselbe Objekt. Eine gültige leere Ansicht kann einen Offset ungleich null haben. Größenänderung und Vergrößerung sind in ECMAScript 2024 spezifiziert; prüfe die Unterstützung in der Zielumgebung.
Beispiele
{
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log([
view.buffer === buffer,
view.byteOffset,
view.byteLength,
view.length,
view.buffer.byteLength,
].join(" "));
view[0] = 513;
console.log(String(new Uint16Array(buffer)[2]));
}Ergebnis
true 4 6 3 16 513
Die Ansicht beginnt bei Byte 4 und umfasst drei Elemente zu je zwei Bytes, also 6 von 16 Bytes. Der Schreibzugriff auf Index 0 ist an Index 2 der Ansicht auf den ganzen Puffer sichtbar.
Zugehörige Lektionen
- JavaScript · Lektion 2 · Fortgeschritten · Version: 4