CKTIS / JavaScript
Dĺžka poľa: Array.length
Vlastnosť length určuje dĺžku poľa, nie však nevyhnutne počet existujúcich prvkov. Priradenie hodnoty môže prvky odstrániť alebo zväčšiť dĺžku bez vyplnenia nových pozícií.
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
array.length
array.length = newLengthArray.length tu označuje vlastnosť length inštancie poľa, čítanú ako array.length, nie vlastnosť konštruktora Array. Je to vlastnosť, nie metóda. Jej hodnota je celé číslo od 0 po 2 ** 32 - 1 vrátane.
Dĺžka nie je počtom existujúcich prvkov: pole môže obsahovať prázdne pozície. Ak priradenie vytvorí prvok na indexe poľa, ktorý sa rovná aktuálnej dĺžke alebo je od nej väčší, length sa zväčší na hodnotu tohto indexu plus jedna. Ak bola vlastnosť length nastavená ako nezapisovateľná, takéto priradenie nepridá prvok ani nezväčší dĺžku poľa: v prísnom režime vyvolá TypeError, inak zlyhá bez ohlásenia chyby. delete array[i] odstráni prvok, ak ide o vlastnú konfigurovateľnú vlastnosť poľa, ale dĺžku nezmenší. Ak vlastná vlastnosť na danom indexe nie je konfigurovateľná, zostane na mieste: mimo prísneho režimu delete vráti false, v prísnom režime vyvolá TypeError.
Priradenie menšej dĺžky odstráni vlastné prvky, ktorých indexy sú väčšie alebo rovné novej dĺžke. Zväčšenie dĺžky nevytvorí prvky s hodnotou undefined; ponechá prázdne pozície. V príklade zápis na index 4 nastaví dĺžku na 5 a neskoršie skrátenie na 2 tento prvok odstráni.
Ak priradenie do array.length dospeje ku kontrole novej dĺžky, záporné číslo, zlomok, ktorý nie je celým číslom, NaN, Infinity alebo 2 ** 32 vyvolá RangeError. Ak vlastnosť length nie je zapisovateľná, priradenie sa odmietne bez kontroly novej dĺžky: v prísnom režime vyvolá TypeError, inak zlyhá bez ohlásenia chyby. Spočiatku je length zapisovateľná, nevymenovateľná a nekonfigurovateľná. Nekonfigurovateľný prvok môže skráteniu zabrániť: dĺžka sa zastaví na jeho indexe plus jedna. V prísnom režime toto priradenie vyvolá TypeError a prvky s vyššími indexmi už mohli byť odstránené.
Príklady
const items = [10, 20];
items[4] = 50;
console.log(items.length);
console.log(Object.hasOwn(items, 2));
items.length = 2;
console.log(JSON.stringify(items));
items.length = 4;
console.log(items.length);
console.log(Object.hasOwn(items, 2));Výsledok
5 false [10,20] 4 false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.