[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array/at [Back]  [Original]

Array.prototype.at() - JavaScript | MDN

Esta pgina ha sido traducida del ingls por la comunidad. Aprende ms y nete a la comunidad de MDN Web Docs.

View in English Always switch to English

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 marzo de 2022.

El mtodo at() recibe un valor numrico entero y devuelve el elemento en esa posicin, permitiendo valores positivos y negativos. Los valores negativos contarn desde el ltimo elemento del array.

Esto no sugiere que haya algo mal con usar la notacin de corchetes. Por ejemplo, array[0] devolvera el primer elemento. Sin embargo, en lugar de usar array.length para los ltimos elementos; ej. array[array.length-1] para el ltimo elemento, puede llamar array.at(-1). (Ver los ejemplos siguientes)

In this article

Prubalo

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"

Sintaxis

js
at(ndice);

Parmetros

ndice

El ndice (posicin) del elemento del array que se devolver. Soporta el ndice relativo desde el final del array cuando se pasa un ndice negativo; ej. si se usa un nmero negativo, el elemento devuelto se encontrar contando hacia atrs desde el final del array.

Valor de retorno

El elemento en el array que coincide con el ndice dado. Devuelve undefined si el ndice dado no se puede encontrar.

Ejemplos

Retorna el ltimo valor de un array

El siguiente ejemplo proporciona una funcin que devuelve el ltimo elemento encontrado en un array especificado.

js
// Nuestro array con objetos
const carrito = ["manzana", "pltano", "pera"];

// Una funcin que devuelve el ltimo elemento de un array dado
function devolverUltimo(arr) {
  return arr.at(-1);
}

// Obtenemos el ltimo elemento de nuestro array 'carrito'
const objeto1 = devolverUltimo(carrito);
console.log(objeto1); // Muestra: 'pera'

// Aade un elemento a nuestro array 'carrito'
carrito.push("naranja");
const objeto2 = devolverUltimo(carrito);
console.log(objeto2); // Muestra: 'naranja'

Comparando mtodos

Este ejemplo compara diferentes maneras de seleccionar el penltimo (uno antes del ltimo) elemento de un Array. Mientras todos los mtodos mostrados a continuacin son vlidos, este ejemplo resalta la concisin y la fcil lectura del mtodo at().

js
// Nuestro array con elementos
const colores = ["rojo", "verde", "azul"];

// Usando la propiedad length
const lengthMetodo = colores[colores.length - 2];
console.log(lengthMetodo); // Muestra: 'verde'

// Usando el mtodo slice(). Note que se devuelve un array
const sliceMetodo = colores.slice(-2, -1);
console.log(sliceMetodo[0]); // Muestra: 'verde'

// Usando el mtodo at()
const atMetodo = colores.at(-2);
console.log(atMetodo); // Muestra: 'verde'

Especificaciones

Specification
ECMAScript 2027 LanguageSpecification
# sec-array.prototype.at

Compatibilidad con navegadores

Vase tambin


Web Proxy Viewer  |  New URL  |  Original Page