WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Uint16Array — vorzeichenloses 16-Bit-Typarray

Uint16Array ist eine typisierte Puffersicht, die Ganzzahlen von 0 bis 65535 mit 2 Byte pro Element speichert. Erfahre, wie Werte umgewandelt werden und worin sich das Kopieren von Daten vom Teilen einer Sicht unterscheidet.

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

new Uint16Array(length)
new Uint16Array(iterableOrArrayLike)
new Uint16Array(typedArray)
new Uint16Array(buffer, byteOffset?, length?)

Uint16Array ist ein integriertes typisiertes Array von ECMAScript und kein gewöhnliches Array. Jedes Element belegt 2 Byte und wird beim Lesen als Number zwischen 0 und 65535 zurückgegeben. length gibt die Anzahl der Elemente an, byteLength die Bytezahl der Sicht und Uint16Array.BYTES_PER_ELEMENT ist 2.

Der Konstruktor erfordert new. Bei einem numerischen Argument bestimmt der Konstruktor mit ToIndex, wie viele mit Nullen gefüllte Elemente er anlegt. Beispielsweise legt new Uint16Array(3.9) drei Elemente an, während new Uint16Array(-1) einen RangeError auslöst. Eine Sammlung liefert zu kopierende Werte. Die ArrayBuffer-Variante erstellt eine Sicht ohne Kopieren: byteOffset wird in Byte angegeben und muss ein Vielfaches von 2 sein. Das optionale length zählt Elemente, nicht Byte.

Beim Schreiben werden Werte umgewandelt, statt auf ihren Wertebereich geprüft: Endliche Number-Werte werden gegen null abgeschnitten und anschließend modulo 65536 reduziert. Daher wird 65536 zu 0, -1 zu 65535 und 3.9 zu 3. NaN und Unendlichkeiten werden zu 0; BigInt-Werte lösen einen TypeError aus. Es handelt sich nicht um eine Begrenzung auf den Wertebereich.

subarray() teilt den Speicher mit dem Original, während slice() Daten kopiert. Das Beispiel zeigt die Umwandlung und die Änderung des Originals über eine Sicht. Die Byte-Reihenfolge ist die der jeweiligen Implementierung; für ein Binärformat mit festgelegter Byte-Reihenfolge ist DataView zu verwenden.

Beispiele

const values = new Uint16Array([65535, 65536, -1, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(`${values.length} ${values.byteLength} ${Uint16Array.BYTES_PER_ELEMENT}`);

Ergebnis

65535,42,65535,3
4 8 2

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.

Quellen