Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

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

Zdroje