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

CKTIS / JavaScript

Délka pole: Array.length

Vlastnost length určuje délku pole, ne však nutně počet existujících prvků. Přiřazení hodnoty může prvky odstranit nebo délku zvětšit, aniž by se nové pozice zaplnily.

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

Syntaxe

array.length
array.length = newLength

Array.length zde označuje vlastnost length instance pole, čtenou jako array.length, nikoli vlastnost konstruktoru Array. Jde o vlastnost, nikoli metodu. Její hodnota je celé číslo od 0 do 2 ** 32 - 1 včetně.

Délka není počet existujících prvků: pole může obsahovat prázdné pozice. Pokud přiřazení vytvoří prvek na indexu pole, který je větší než aktuální délka nebo se jí rovná, length se zvětší na hodnotu tohoto indexu plus jedna. Pokud byla vlastnost length nastavena jako nezapisovatelná, takové přiřazení prvek nepřidá ani pole neprodlouží: v přísném režimu vyvolá TypeError, jinak selže bez ohlášení chyby. delete array[i] odstraní prvek, pokud jde o vlastní konfigurovatelnou vlastnost pole, ale délku nezmenší. Pokud vlastní vlastnost na daném indexu není konfigurovatelná, zůstane na místě: mimo přísný režim delete vrátí false, v přísném režimu vyvolá TypeError.

Přiřazení menší délky odstraní vlastní prvky, jejichž indexy jsou větší než nebo rovny nové délce. Zvětšení délky nevytvoří prvky s hodnotou undefined; ponechá prázdné pozice. V příkladu zápis na index 4 nastaví délku na 5 a následné zkrácení na 2 tento prvek odstraní.

Pokud přiřazení do array.length dospěje ke kontrole nové délky, záporné číslo, zlomek, který není celým číslem, NaN, Infinity nebo 2 ** 32 vyvolá RangeError. Pokud vlastnost length není zapisovatelná, přiřazení se odmítne bez kontroly nové délky: v přísném režimu vyvolá TypeError, jinak selže bez ohlášení chyby. Zpočátku je vlastnost length zapisovatelná a nekonfigurovatelná a příznak enumerable má hodnotu false. Nekonfigurovatelný prvek může zkrácení zabránit: délka se zastaví na jeho indexu plus jedna. V přísném režimu toto přiřazení vyvolá TypeError a prvky s vyššími indexy už mohly být odstraněny.

Pří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ýsledek

5
false
[10,20]
4
false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje