JavaScript at()Método
Objeto JavaScript ArrayEjemplo
Recibe un valor entero y devuelve el elemento correspondiente a ese índice:
Pruébalo »
Definición y uso
El método at() se utiliza para recibir un valor entero y devolver el elemento correspondiente a ese índice, permitiendo números positivos y negativos. Los enteros negativos cuentan desde el último elemento del array hacia atrás.
Devuelve el elemento del array que coincide con el índice dado. Si no se encuentra el índice especificado, devuelve undefined.
Al pasar un número no negativo, el método at() es equivalente a la notación de corchetes. Por ejemplo, array
La práctica habitual es acceder a length y restarle el índice relativo desde el final. Por ejemplo, array[array.length - 1]. El método at() permite usar índices relativos, por lo que el ejemplo anterior se puede simplificar a array.at(-1). Más formalmente, cuando index < 0, el método accede al índice index + array.length.
El método at() es genérico. Solo espera que this tenga una propiedad length y propiedades con claves de número entero.
Compatibilidad del navegador
Los números de la tabla indican la primera versión del navegador compatible con este método.
| Método | |||||
|---|---|---|---|---|---|
| at() | 45.0 | 12.0 | 32.0 | 9 | 25.0 |
Sintaxis
at(index)
Parámetros
| Parámetro | Descripción |
| index | El índice (posición) del elemento del array que se va a devolver. Cuando se pasa un número negativo, se admite un índice relativo desde el final del array; es decir, si se usa un número negativo, el elemento devuelto se contará desde el final del array. |
Detalles técnicos
| Valor de retorno: | El elemento. |
| Versión de JavaScript: | ECMAScript 6 |
Más ejemplos
Devuelve el último valor del array:El siguiente ejemplo proporciona una función que devuelve el último elemento encontrado en un array dado.
Ejemplo
const cart = ['apple', 'banana', 'pear'];
// una función para devolver el último elemento de un array dado
function returnLast(arr) {
return arr.at(-1);
}
// obtiene el último elemento del array 'cart'
const item1 = returnLast(cart);
console.log(item1); // salida: 'pear'
// agrega un elemento al array 'cart'
cart.push('orange');
const item2 = returnLast(cart);
console.log(item2); // salida: 'orange'
Comparando diferentes métodos de array:El siguiente ejemplo compara diferentes formas de seleccionar el penúltimo elemento del Array. Aunque todos los métodos mostrados a continuación son válidos, este ejemplo resalta la simplicidad y legibilidad del método at().
Ejemplo
const colors = ['red', 'green', 'blue'];
// usando la propiedad length
const lengthWay = colors[colors.length-2];
console.log(lengthWay); // salida: 'green'
// usando el método slice(). Nótese que devuelve un array
const sliceWay = colors.slice(-2, -1);
console.log(sliceWay[0]); // salida: 'green'
// usando el método at()
const atWay = colors.at(-2);
console.log(atWay); // salida: 'green'
Llamar a at() en objetos no array: el método at() lee la propiedad length de this y calcula el índice al que necesita acceder.
Ejemplo
length: 2,
0: "a",
1: "b",
};
console.log(Array.prototype.at.call(arrayLike, -1)); // "b"
Otras extensiones