WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Uint8ClampedArray — Bytes mit begrenzten Werten

Uint8ClampedArray ist ein typisiertes Array, das ganze Zahlen von 0 bis 255 speichert. Beim Schreiben werden Werte auf diesen Bereich begrenzt und Nachkommastellen gerundet, statt wie bei Uint8Array überzulaufen.

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

Uint8ClampedArray ist ein standardisierter ECMAScript-Typ: eine Sicht auf einen Puffer, deren Elemente jeweils ein Byte belegen und vorzeichenlose Ganzzahlen von 0 bis 255 darstellen. Ausgelesene Werte haben den Typ Number; es handelt sich nicht um ein gewöhnliches Array.

Beim Schreiben wird ToUint8Clamp angewendet: Werte unter 0 werden zu 0, Werte über 255 zu 255. Nachkommastellen werden auf die nächste Ganzzahl gerundet; bei exakten Halbwerten wird zur geraden Zahl gerundet. Daher wird 2.5 zu 2 und 3.5 zu 4. Das unterscheidet sich von Math.round. NaN wird zu 0, Infinity zu 255 und -Infinity zu 0. Uint8Array schneidet Nachkommastellen dagegen ab und lässt Ganzzahlen modulo 256 überlaufen.

new Uint8ClampedArray(length) erstellt mit Nullen gefüllte Elemente, während new Uint8ClampedArray(values) Werte kopiert und umwandelt. Die Variante mit buffer erstellt ohne Kopieren eine Sicht auf vorhandenen Speicher; durch das Erstellen der Sicht allein werden die gespeicherten Bytes nicht umgewandelt. Der Konstruktor erfordert new.

Das Beispiel zeigt Begrenzung und Rundung beim Erstellen und bei einer anschließenden Zuweisung. Die Begrenzung gilt für Schreibvorgänge auf Elemente, nicht für Berechnungen mit aus dem Array ausgelesenen Zahlen. Dies ist eine Sprachfunktion, keine Browser-API; die Spezifikation ist keine Browser-Kompatibilitätstabelle.

Beispiele

const values = new Uint8ClampedArray([-20, 2.5, 3.5, 300, NaN]);
values[0] = 260;
console.log(JSON.stringify(Array.from(values)));

Ergebnis

[255,2,4,255,0]

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