CKTIS / JavaScript
TypedArray.length — počet prvků pohledu
TypedArray.length udává počet prvků typovaného pole, nikoli počet bajtů. Hodnotu čtěte z instance, například pomocí values.length; ke změně velikosti pohledu neslouží.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
typedArray.lengthTypedArray.length zde označuje vlastnost instance dokumentovanou jako TypedArray.prototype.length. Čtěte ji pomocí typedArray.length, bez závorek pro volání. TypedArray je společná abstrakce konkrétních typů, jako je Uint16Array, nikoli globální konstruktor, který lze přímo použít.
length počítá prvky pohledu. byteLength počítá bajty tohoto pohledu, zatímco buffer.byteLength popisuje celý buffer. Každý prvek Uint16Array zabírá 2 bajty, takže pohled s hodnotou length rovnou 3 má byteLength rovné 6. Pohled může pokrývat jen část bufferu. V konstruktoru se byteOffset zadává v bajtech a length v prvcích.
Tato vlastnost je přístupový prvek bez setteru: přiřazení hodnoty do length nezmění velikost typovaného pole. U bufferu se změnitelnou velikostí se však length pohledu sledujícího délku může měnit spolu s bufferem. Pokud zmenšení bufferu způsobí, že rozsah pohledu přestane být platný, čtení vlastnosti vrátí 0, a to i u pohledu s pevnou délkou. Podporu bufferů se změnitelnou velikostí ověřujte zvlášť; samotný přístup k length ji nedokazuje.
Příklady
const buffer = new ArrayBuffer(12);
const values = new Uint16Array(buffer, 2, 3);
console.log(values.length);
console.log(values.byteLength);
console.log(buffer.byteLength);Výsledek
3 6 12
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.