CKTIS / JavaScript
TypedArray.length — liczba elementów widoku
TypedArray.length oznacza liczbę elementów tablicy typowanej, nie liczbę bajtów. Właściwość odczytuje się z instancji, np. values.length; nie służy ona do zmiany rozmiaru widoku.
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.lengthTypedArray.length to tutaj oznaczenie właściwości instancji, udokumentowanej jako TypedArray.prototype.length. Odczytuj ją przez typedArray.length, bez nawiasów wywołania. TypedArray jest wspólną abstrakcją konkretnych typów, takich jak Uint16Array, a nie globalnym konstruktorem dostępnym do bezpośredniego użycia.
length liczy elementy widoku. byteLength liczy bajty tego widoku, natomiast buffer.byteLength opisuje cały bufor. Dla Uint16Array każdy element zajmuje 2 bajty, więc widok o length równym 3 ma byteLength równe 6. Widok może obejmować tylko część bufora. W konstruktorze byteOffset podaje się w bajtach, a length w elementach.
Właściwość jest akcesorem bez settera: przypisanie do length nie zmienia rozmiaru tablicy typowanej. Przy buforze o zmiennym rozmiarze widok śledzący długość może jednak zmieniać length wraz z buforem. Jeśli zmniejszenie bufora sprawi, że zakres widoku przestanie być prawidłowy, odczyt zwróci 0, również dla widoku o ustalonej długości. Obsługę buforów o zmiennym rozmiarze sprawdzaj osobno; sam dostęp do length jej nie dowodzi.
Przykłady
const buffer = new ArrayBuffer(12);
const values = new Uint16Array(buffer, 2, 3);
console.log(values.length);
console.log(values.byteLength);
console.log(buffer.byteLength);Wynik
3 6 12
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.