Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Uint8ClampedArray — bajty z ograniczaniem wartości

Uint8ClampedArray to tablica typowana przechowująca liczby całkowite od 0 do 255. Przy zapisie ogranicza wartości do tego zakresu i zaokrągla ułamki, zamiast zawijać wartości jak Uint8Array.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

new Uint8ClampedArray(length)
new Uint8ClampedArray(values)
new Uint8ClampedArray(buffer)
new Uint8ClampedArray(buffer, byteOffset)
new Uint8ClampedArray(buffer, byteOffset, length)

Uint8ClampedArray jest standardowym typem ECMAScript: widokiem na bufor, którego każdy element zajmuje jeden bajt i reprezentuje liczbę całkowitą bez znaku od 0 do 255. Odczytane wartości mają typ Number; nie jest to zwykła tablica Array.

Zapis stosuje konwersję ToUint8Clamp: wartości poniżej 0 stają się 0, a powyżej 255 — 255. Ułamki są zaokrąglane do najbliższej liczby całkowitej; dokładne remisy trafiają do parzystej, więc 2.5 daje 2, a 3.5 daje 4. To inna reguła niż w Math.round. NaN daje 0, Infinity daje 255, a -Infinity daje 0. Uint8Array zamiast tego obcina ułamki i zawija wartości całkowite modulo 256.

new Uint8ClampedArray(length) tworzy wyzerowane elementy, a new Uint8ClampedArray(values) kopiuje i konwertuje wartości. Wariant z buffer tworzy widok na istniejącą pamięć, bez kopiowania; samo utworzenie widoku nie przelicza zapisanych bajtów. Konstruktor wymaga new.

Przykład pokazuje ograniczanie i zaokrąglanie podczas konstrukcji oraz późniejszego przypisania. Ograniczanie dotyczy zapisu elementów, a nie obliczeń wykonywanych na odczytanych liczbach. Jest to funkcja języka, nie API przeglądarki; specyfikacja nie jest tabelą zgodności przeglądarek.

Przykłady

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

Wynik

[255,2,4,255,0]

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła