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

CKTIS / JavaScript

Array.prototype.at: prvek podle relativního indexu

Metoda at čte prvek pole a záporným indexem počítá od konce bez ručního použití length.

Verze: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntaxe

array.at(index)

array.at(index) převede index na celé číslo oříznutím desetinné části. Nezáporný index počítá od začátku, záporný relativně k array.length; -1 je poslední prvek. Metoda je obecná pro array-like příjemce a nemění je.

Je-li vypočtený index mimo rozsah, vrátí undefined bez čtení vlastnosti. Totéž dá i mezera v poli. NaN se chová jako index 0, zatímco Infinity je mimo rozsah.

Příjemce null nebo undefined vyvolá TypeError. Na rozdíl od array[-1], které hledá vlastnost "-1", at(-1) skutečně počítá od konce. Příklad ukazuje záporný, neplatný a desetinný index.

Příklady

const values = ["first", "middle", "last"];
console.log(values.at(-1));
console.log(values.at(-4));
console.log(values.at(1.9));

Výsledek

last
undefined
middle

Zdroje