CKTIS / JavaScript
Délka a indexování polí v JavaScriptu
`length` určuje horní mez indexů pole, ale nepočítá prvky. Zápis na index může tuto mez posunout a prázdná pozice není totéž co hodnota `undefined`.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
a.length; a[i]; a[i] = value; a.length = n; delete a[i]; Object.hasOwn(a, i); a.at(i);Indexy pole začínají nulou. a.length je vlastní vlastnost pole, ve výchozím stavu zapisovatelná, ale nekonfigurovatelná. Její hodnota je celé číslo od 0 do 2 ** 32 - 1. Je to horní mez, které indexy vlastních prvků nesmějí dosáhnout, nikoli jejich počet. Naproti tomu Array.length udává počet parametrů očekávaných funkcí konstruktoru, ne délku pole.
Hranaté závorky zpřístupňují vlastnosti: a[1] a a["1"] používají stejný klíč. Indexy pole jsou kanonické desetinné zápisy celých čísel od 0 do 2 ** 32 - 2. Klíče jako "01", "-1" a "4294967295" nejsou indexy a délku nemění. a[-1] hledá vlastnost "-1"; a.at(-1) čte poslední pozici neprázdného pole. Je-li vypočtený index mimo rozsah, at() vrátí undefined, aniž by danou vlastnost vyhledávalo.
Vytvoření vlastního prvku na indexu i >= a.length zvětší délku na i + 1. Přeskočené pozice zůstanou prázdné. Prázdná pozice nemá vlastní vlastnost; při čtení dostaneme undefined, pokud se hodnota nezdědí. Object.hasOwn(a, i) odliší prázdnou pozici od vlastního prvku s hodnotou undefined. Úspěšné delete a[i] odstraní prvek, ale pole nezkrátí.
Zvětšení length přidává prázdné pozice, zmenšení maže vlastní prvky od nové meze výše. Je-li length zapisovatelná, přiřazení hodnoty typu Number, která není celým číslem nebo leží mimo povolený rozsah, vyvolá RangeError. Přiřazení hodnoty typu BigInt naproti tomu vyvolá TypeError už při převodu, ještě před kontrolou rozsahu. Nekonfigurovatelný prvek může zkrácení zastavit: prvky s vyššími indexy už mohou být smazané a výsledná délka je index překážejícího prvku plus jedna. V přísném režimu toto neúspěšné přiřazení vyvolá TypeError.
Příklady
{
const a = ["A"];
a[3] = "D";
a[2] = undefined;
a[-1] = "tag";
console.log(`length: ${a.length}`);
console.log(`1: ${a[1]}, own: ${Object.hasOwn(a, 1)}`);
console.log(`2: ${a[2]}, own: ${Object.hasOwn(a, 2)}`);
console.log(`[-1]: ${a[-1]}, at(-1): ${a.at(-1)}`);
a.length = 1;
a.length = 4;
console.log(`length: ${a.length}, own 3: ${Object.hasOwn(a, 3)}, [-1]: ${a[-1]}`);
}Výsledek
length: 4 1: undefined, own: false 2: undefined, own: true [-1]: tag, at(-1): D length: 4, own 3: false, [-1]: tag
Při čtení pozic `1` i `2` dostaneme `undefined`, ale jen `2` je vlastní prvek. Opětovné prodloužení neobnoví prvek `3`; vlastnost `"-1"` zůstane.
Související lekce
- JavaScript · Lekce 41 · Pokročilá · Verze: 4