CKTIS / JavaScript
Uint32Array — Array vorzeichenloser 32-Bit-Ganzzahlen
Uint32Array ist eine typisierte Ansicht auf einen Puffer: Jedes Element belegt 4 Bytes und speichert eine Zahl von 0 bis 4294967295. Erfahre mehr über die Wertumwandlung, das Erstellen von Ansichten und den Unterschied zwischen gemeinsam genutztem Speicher und Kopien.
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 Uint32Array(length)
new Uint32Array(iterableOrArrayLike)
new Uint32Array(typedArray)
new Uint32Array(buffer[, byteOffset[, length]])Uint32Array ist ein typisiertes Array: eine Speicheransicht, deren Elemente als Number-Werte von 0 bis 4294967295 gelesen werden. Jedes Element belegt 4 Bytes; length zählt Elemente, byteLength dagegen Bytes. Es ist kein gewöhnliches Array und hat keine Methode push().
new Uint32Array(length) erstellt einen mit Nullen gefüllten Puffer. Bei der Konstruktion aus einem iterierbaren Objekt oder einem anderen typisierten Array mit Elementen vom Typ Number werden die Werte kopiert. Ist die Quelle ein BigInt64Array oder BigUint64Array, löst der Konstruktor einen TypeError aus, auch wenn das Quellarray leer ist. Bei der Konstruktion aus einem ArrayBuffer wird dessen Speicher gemeinsam genutzt. byteOffset muss ein Vielfaches von 4 sein; ein ausdrücklich angegebenes length zählt Elemente, nicht Bytes.
Beim Schreiben wird die Umwandlung ToUint32 angewendet: Der Wert wird gegen null abgeschnitten und das Ergebnis anschließend modulo 2 ** 32 genommen. Daher wird -1 zu 4294967295 und 2 ** 32 + 7 zu 7. NaN und Unendlichkeiten werden zu 0; beim Schreiben eines BigInt wird ein TypeError ausgelöst. Dabei handelt es sich um eine Umwandlung, nicht um eine Bereichsprüfung.
subarray() nutzt denselben Speicher, während slice() die Elemente kopiert. Die Byte-Reihenfolge ist von der jeweiligen Implementierung abhängig; verwende DataView für Binärformate, die eine explizite Byte-Reihenfolge erfordern. Im Beispiel ändert eine Änderung von view[0] auch values[1].
Beispiele
const values = new Uint32Array([1, -1, 2 ** 32 + 7, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(values.length, values.byteLength, Uint32Array.BYTES_PER_ELEMENT);Ergebnis
1,42,7,3 4 16 4
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.