CKTIS / JavaScript
Uint8Array — widok bajtów bez znaku
Uint8Array udostępnia dane bufora jako 8-bitowe liczby całkowite bez znaku z zakresu 0–255. Pozwala tworzyć bajty, kopiować je lub współdzielić pamięć przez widoki; zapis poza zakresem zawija wartość zamiast ją ograniczać.
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 Uint8Array(length)
new Uint8Array(values)
new Uint8Array(buffer[, byteOffset[, length]])Uint8Array to tablica typowana: widok bufora, którego każdy element zajmuje jeden bajt i przy odczycie jest wartością Number z zakresu 0–255. Nie jest zwykłą tablicą Array. Właściwość length podaje liczbę elementów, byteLength rozmiar widoku w bajtach, a buffer udostępnia bufor bazowy.
new Uint8Array(length) tworzy bufor wypełniony zerami. new Uint8Array(values) kopiuje wartości z obiektu iterowalnego lub tablicopodobnego. new Uint8Array(buffer, byteOffset, length) tworzy widok istniejącego bufora bez kopiowania; byteOffset jest przesunięciem w bajtach, a length liczbą elementów. Konstruktor wymaga new.
Przy zapisie skończone liczby są obcinane w kierunku zera, a następnie sprowadzane modulo 256: 256 staje się 0, a -1 staje się 255. NaN i nieskończoności stają się 0. To nie jest walidacja zakresu ani ograniczanie wartości jak w Uint8ClampedArray; nieprawidłowe dane należy sprawdzać przed zapisem.
subarray() tworzy widok współdzielący pamięć, natomiast slice() tworzy niezależną kopię. W przykładzie zmiana view[0] zmienia również bytes[1], lecz nie zmienia copy. Wpis obejmuje podstawowe operacje ECMAScript, nie nowsze metody kodowania. Sama specyfikacja nie potwierdza zgodności konkretnej przeglądarki; obecność Node 24 w repozytorium również jej nie dowodzi.
Przykłady
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);Wynik
0,42,0,255 255,0 4:4
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.