CKTIS / JavaScript
Uint8ClampedArray — bajty s omezenými hodnotami
Uint8ClampedArray je typované pole, které ukládá celá čísla od 0 do 255. Při zápisu omezuje hodnoty na tento rozsah a zaokrouhluje zlomky, místo aby hodnoty přetékaly jako u Uint8Array.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new Uint8ClampedArray(length)
new Uint8ClampedArray(values)
new Uint8ClampedArray(buffer)
new Uint8ClampedArray(buffer, byteOffset)
new Uint8ClampedArray(buffer, byteOffset, length)Uint8ClampedArray je standardní typ ECMAScriptu: pohled na buffer, jehož každý prvek zabírá jeden bajt a představuje nezáporné celé číslo od 0 do 255. Načtené hodnoty mají typ Number; nejde o běžné pole Array.
Při zápisu se použije ToUint8Clamp: hodnoty menší než 0 se změní na 0 a hodnoty větší než 255 na 255. Zlomky se zaokrouhlují na nejbližší celé číslo; přesné poloviny se zaokrouhlují k sudému číslu. Proto se 2.5 změní na 2 a 3.5 na 4. To se liší od Math.round. NaN se změní na 0, Infinity na 255 a -Infinity na 0. Uint8Array zlomky místo toho zkracuje a celá čísla převádí modulo 256.
new Uint8ClampedArray(length) vytvoří prvky vyplněné nulami, zatímco new Uint8ClampedArray(values) hodnoty zkopíruje a převede. Varianta s buffer vytvoří pohled na existující paměť bez kopírování; samotné vytvoření pohledu uložené bajty nepřevede. Konstruktor vyžaduje new.
Příklad ukazuje omezení a zaokrouhlování při vytváření i při následném přiřazení. Omezení se uplatňuje při zápisu do prvků, nikoli při výpočtech s čísly načtenými z pole. Jde o funkci jazyka, nikoli o API prohlížeče; specifikace není tabulkou kompatibility prohlížečů.
Příklady
const values = new Uint8ClampedArray([-20, 2.5, 3.5, 300, NaN]);
values[0] = 260;
console.log(JSON.stringify(Array.from(values)));Výsledek
[255,2,4,255,0]
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.