Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.length

TypedArray.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.

Źródła