WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Uint8Array — eine Ansicht vorzeichenloser Bytes

Uint8Array stellt Pufferdaten als vorzeichenlose 8-Bit-Ganzzahlen von 0 bis 255 bereit. Damit lassen sich Bytes erstellen, kopieren oder über Ansichten gemeinsam nutzen; Schreibvorgänge außerhalb des Wertebereichs werden umgebrochen und nicht begrenzt.

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 Uint8Array(length)
new Uint8Array(values)
new Uint8Array(buffer[, byteOffset[, length]])

Uint8Array ist ein typisiertes Array: eine Pufferansicht, deren Elemente jeweils ein Byte belegen und beim Lesen als Number-Werte von 0 bis 255 zurückgegeben werden. Es ist kein gewöhnliches Array. Die Eigenschaft length gibt die Anzahl der Elemente an, byteLength die Größe der Ansicht in Bytes und buffer den zugrunde liegenden Puffer.

new Uint8Array(length) erstellt einen mit Nullen gefüllten Puffer. new Uint8Array(values) kopiert Werte aus einem iterierbaren oder arrayähnlichen Objekt. new Uint8Array(buffer, byteOffset, length) erstellt ohne Kopieren eine Ansicht eines vorhandenen Puffers; byteOffset ist ein Versatz in Bytes und length gibt die Anzahl der Elemente an. Der Konstruktor muss mit new aufgerufen werden.

Bei einer Zuweisung werden endliche Zahlen gegen null abgeschnitten und anschließend modulo 256 reduziert: 256 wird zu 0, und -1 wird zu 255. NaN und Unendlichkeiten werden zu 0. Das ist weder eine Bereichsprüfung noch eine Begrenzung wie bei Uint8ClampedArray; ungültige Eingaben sollten vor dem Schreiben geprüft werden.

subarray() erstellt eine Ansicht, die den Speicher gemeinsam nutzt, während slice() eine unabhängige Kopie erstellt. Im Beispiel ändert eine Änderung von view[0] auch bytes[1], lässt copy jedoch unverändert. Dieser Eintrag behandelt grundlegende ECMAScript-Operationen, nicht neuere Kodierungsmethoden. Die Spezifikation allein belegt keine Kompatibilität mit einem bestimmten Browser; auch das Vorhandensein von Node 24 in einem Repository belegt sie nicht.

Beispiele

const bytes = new Uint8Array([0, 255, 256, -1]);
const view = bytes.subarray(1, 3);
const copy = bytes.slice(1, 3);
view[0] = 42;
console.log(bytes.join(','));
console.log(copy.join(','));
console.log(bytes.length + ':' + bytes.byteLength);

Ergebnis

0,42,0,255
255,0
4: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.

Quellen