Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

TypedArray.length — počet prvkov pohľadu

TypedArray.length udáva počet prvkov typovaného poľa, nie počet bajtov. Hodnotu čítajte z inštancie, napríklad pomocou values.length; na zmenu veľkosti pohľadu neslúži.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

typedArray.length

TypedArray.length tu označuje vlastnosť inštancie zdokumentovanú ako TypedArray.prototype.length. Čítajte ju pomocou typedArray.length, bez zátvoriek na volanie. TypedArray je spoločná abstrakcia konkrétnych typov, ako je Uint16Array, nie globálny konštruktor, ktorý možno priamo použiť.

length počíta prvky pohľadu. byteLength počíta bajty tohto pohľadu, zatiaľ čo buffer.byteLength opisuje celý buffer. Každý prvok Uint16Array zaberá 2 bajty, takže pohľad s hodnotou length rovnou 3 má byteLength rovnú 6. Pohľad môže pokrývať iba časť buffera. V konštruktore sa byteOffset zadáva v bajtoch a length v prvkoch.

Táto vlastnosť je prístupový prvok bez setteru: priradenie hodnoty do length nezmení veľkosť typovaného poľa. Pri buffri s meniteľnou veľkosťou sa však length pohľadu sledujúceho dĺžku môže meniť spolu s buffrom. Ak zmenšenie buffera spôsobí, že rozsah pohľadu prestane byť platný, čítanie vlastnosti vráti 0, a to aj pri pohľade s pevnou dĺžkou. Podporu bufferov s meniteľnou veľkosťou overujte osobitne; samotný prístup k length ju nedokazuje.

Prí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ýsledok

3
6
12

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje