CKTIS / JavaScript
Uint16Array — 16-bitowa tablica bez znaku
Uint16Array to typowany widok bufora przechowujący liczby całkowite od 0 do 65535, po 2 bajty na element. Poznaj konwersję wartości oraz różnicę między kopią danych a współdzielonym widokiem.
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 Uint16Array(length)
new Uint16Array(iterableOrArrayLike)
new Uint16Array(typedArray)
new Uint16Array(buffer, byteOffset?, length?)Uint16Array jest wbudowanym typem ECMAScript z rodziny tablic typowanych, a nie zwykłą Array. Każdy element zajmuje 2 bajty i przy odczycie jest wartością Number od 0 do 65535. length podaje liczbę elementów, byteLength liczbę bajtów widoku, a Uint16Array.BYTES_PER_ELEMENT wynosi 2.
Konstruktor wymaga new. W przypadku argumentu liczbowego konstruktor stosuje ToIndex, aby ustalić liczbę elementów wypełnionych zerami. Na przykład new Uint16Array(3.9) tworzy trzy elementy, a new Uint16Array(-1) zgłasza RangeError. Kolekcja dostarcza wartości do skopiowania. Wariant z ArrayBuffer tworzy widok bez kopiowania: byteOffset jest przesunięciem w bajtach i musi być wielokrotnością 2, natomiast opcjonalne length oznacza liczbę elementów, nie bajtów.
Zapis konwertuje wartości, zamiast sprawdzać ich zakres: dla skończonych wartości Number odrzuca część ułamkową w kierunku zera, a następnie stosuje modulo 65536. Dlatego 65536 daje 0, -1 daje 65535, a 3.9 daje 3. NaN i nieskończoności dają 0; wartości BigInt powodują TypeError. Nie jest to konwersja z nasyceniem.
subarray() współdzieli pamięć z oryginałem, natomiast slice() kopiuje dane. Przykład pokazuje konwersję i zmianę oryginału przez widok. Kolejność bajtów jest właściwa dla implementacji; do formatu binarnego z określoną kolejnością użyj DataView.
Przykłady
const values = new Uint16Array([65535, 65536, -1, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(`${values.length} ${values.byteLength} ${Uint16Array.BYTES_PER_ELEMENT}`);Wynik
65535,42,65535,3 4 8 2
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.