CKTIS / JavaScript
TypedArray.byteLength — długość widoku w bajtach
Właściwość byteLength podaje liczbę bajtów objętych widokiem tablicy typowanej, a nie liczbę elementów ani rozmiar całego bufora. Jest odczytywana z instancji i nie ma settera.
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
typedArray.byteLengthTypedArray.byteLength oznacza tutaj właściwość instancji, formalnie TypedArray.prototype.byteLength. Odczytuj ją jako typedArray.byteLength, bez nawiasów. TypedArray nie jest globalnym konstruktorem; użyj konkretnego typu, np. Uint16Array. Właściwość nie ma settera: przypisanie do niej nie zmienia rozmiaru widoku.
length liczy elementy, a byteLength bajty: typedArray.byteLength === typedArray.length * typedArray.BYTES_PER_ELEMENT. Natomiast typedArray.buffer.byteLength opisuje cały bufor, a byteOffset wskazuje początek widoku w bajtach. Widok może obejmować tylko część bufora; jego byteLength nie jest miarą całkowitego zużycia pamięci przez obiekt.
Dla bufora o zmiennym rozmiarze widok śledzący długość może zmieniać byteLength. Widok o ustalonej długości nie rozszerza się wraz z buforem. Jeśli zmniejszenie bufora sprawi, że zakres widoku przestanie być prawidłowy, byteLength wyniesie 0.
Podstawowa właściwość jest szeroko dostępna w przeglądarkach od lipca 2015 r.; obsługę buforów o zmiennym rozmiarze należy sprawdzać osobno. W przykładzie trzeci argument Uint16Array oznacza 3 elementy, nie 3 bajty: widok obejmuje 6 bajtów w buforze o rozmiarze 16 bajtów.
Przykłady
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log(view.length);
console.log(view.BYTES_PER_ELEMENT);
console.log(view.byteLength);
console.log(view.byteOffset);
console.log(view.buffer.byteLength);Wynik
3 2 6 4 16
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.