Array.prototype.at()

Baseline Widely available

This feature is well established and works across many devices and browser versions. Its been available across browsers since maro de 2022.

Learn more
See full compatibility

O mtodo at() recebe um valor inteiro e retorna o item referente ao index dele, permitindo valores positivos ou negativos. Valores negativos contam apartir do ltimo item do array.

Isto no quer dizer que exista alguma coisa errada em utilizar a notao com colchetes. Por exemplo array[0] retornaria o primeiro item. Porm ao invs de utilizar o array.length para os ltimos items; e.g array[array.length-1] para o ltimo item, voc pode utilizar o array.at(-1). (Veja os exemplos abaixo)

Experimente

const array1 = [5, 12, 8, 130, 44];

let index = 2;

console.log(`An index of ${index} returns ${array1.at(index)}`);
// Expected output: "An index of 2 returns 8"

index = -2;

console.log(`An index of ${index} returns ${array1.at(index)}`);
// Expected output: "An index of -2 returns 130"

Sintaxe

at(index);

Parmetros

index: O index (posio) do elemento do array que ser retornado. Quando um valor negativo passado como argumento a contagem dos elementos feita de trs para frente.

// O array com items
const cart = ["apple", "banana", "pear"];

// A funo que retorna o ltimo item do array passado como argumento
function returnLast(arr) {
  return arr.at(-1);
}

// Pega o ltimo item do array 'cart'
const item1 = returnLast(cart);
console.log(item1); // 'pear'

// Adiciona um item ao array 'cart'
cart.push("orange");
const item2 = returnLast(cart);
console.log(item2); // 'orange'

Comparando mtodos

Este exemplo compara as diferentes maneiras de selecionar o penltimo item de um Array. Todos os mtodos abaixos so vlidos, mas este exemplo destaca a sucintez e legibilidade do mtodo at().

// O array com items
const colors = ["red", "green", "blue"];

// Usando a propriedade length
const lengthWay = colors[colors.length - 2];
console.log(lengthWay); // 'green'

// Usando o mtodo slice(). Perceba que um array  retornado
const sliceWay = colors.slice(-2, -1);
console.log(sliceWay[0]); // 'green'

// Usando o mtodo at()
const atWay = colors.at(-2);
console.log(atWay); // 'green'