Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje