Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Array.prototype.at: elemento por índice relativo

O método at lê um elemento e permite que um índice negativo conte a partir do fim sem calcular length manualmente.

Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxe

array.at(index)

array.at(index) converte index num inteiro truncando a parte fracionária. Um índice não negativo conta do início; um negativo é relativo a array.length, pelo que -1 é o último elemento. É genérico para recetores array-like e não os altera.

Se o índice calculado ficar fora do intervalo, devolve undefined sem ler a propriedade. Uma posição vazia também dá undefined. NaN equivale ao índice 0, enquanto Infinity fica fora.

Um recetor null ou undefined lança TypeError. Ao contrário de array[-1], que procura a propriedade "-1", at(-1) conta realmente do fim. O exemplo cobre índice negativo, fora do intervalo e fracionário.

Exemplos

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

Resultado

last
undefined
middle

Fontes