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

CKTIS / JavaScript

Délka a indexování polí v JavaScriptu

`length` určuje rozsah pozic pole, nikoli počet přítomných prvků. Zápis na index může pole prodloužit, zatímco zkrácení může některé prvky odstranit.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

a.length
 a[i]
 a[i] = value
 a.length = newLength
 delete a[i]
 Object.hasOwn(a, i)
 a.at(-1)

a.length je vlastní datová vlastnost instance Array, nikoli metoda ani statická vlastnost. Indexy začínají na 0. U nenulové délky označuje a.length - 1 poslední pozici, která může být prázdná. Délka je od 0 do 2 ** 32 - 1; nejvyšší index pole je 2 ** 32 - 2.

a[1] a a["1"] odkazují na stejný klíč vlastnosti. a["01"], a[-1] a a[2 ** 32 - 1] používají klíče, které nejsou indexy pole, takže zápis délku nezmění. Naproti tomu a.at(-1) vyhledá poslední pozici podle délky a vrátí undefined, pokud je délka nulová.

Pokud zápis vytvoří vlastní prvek s indexem i >= a.length, délka vzroste na i + 1 a přeskočené pozice zůstanou prázdné. Prázdná pozice není vlastní prvek s hodnotou undefined: čtení pomocí hranatých závorek může najít zděděnou vlastnost, a pokud odpovídající vlastnost neexistuje, vrátí undefined. Object.hasOwn(a, i) testuje vlastní vlastnost; i in a prohledává i řetězec prototypů.

Zvětšení length nevytvoří žádné prvky. Zmenšení odstraní vlastní prvky s indexem rovným nové délce nebo vyšším, počínaje nejvyšším indexem. Opětovné prodloužení je neobnoví. Úspěšné delete a[i] pole nezkrátí.

Přiřazení čísla mimo povolený rozsah nebo necelého čísla do zapisovatelné vlastnosti length vyvolá RangeError. Nekonfigurovatelný prvek může zkracování zastavit: délka bude o jedna větší než jeho index a předchozí odstranění se nevrátí zpět. V přísném režimu toto neúspěšné přiřazení vyvolá TypeError; mimo něj může selhat bez upozornění.

Příklady

{
  const a = ["A", undefined];
  a[3] = "D";
  console.log(`${a.length} ${a[1]} ${a[2]}`);
  console.log(`${Object.hasOwn(a, 1)} ${Object.hasOwn(a, 2)}`);

  a[-1] = "label";
  console.log(`${a[-1]} ${a.at(-1)} ${a.length}`);

  a.length = 2;
  a.length = 4;
  console.log(`${a.length} ${Object.hasOwn(a, 3)} ${a[-1]}`);
}

Výsledek

4 undefined undefined
true false
label D 4
4 false label

Při čtení vracejí indexy `1` i `2` hodnotu `undefined`, ale jen `1` je vlastní prvek. Klíč `-1` obsahuje `label`, zatímco `a.at(-1)` vrací `D`. Zkrácení odstraní `D`; opětovné prodloužení ho neobnoví ani nezmění vlastnost `-1`.

Související lekce

  • JavaScript · Lekce 28 · Pokročilá · Verze: 4

Zdroje