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