Méthode at()de JavaScript
Exemple
Prend une valeur entière et renvoie l'élément à cet index :
Essayez-le vous-même »
Définition et utilisation
La méthode at() prend une valeur entière et renvoie l'élément à cet index, autorisant des entiers positifs et négatifs. Les entiers négatifs comptent à rebours à partir du dernier élément du tableau.
Renvoie l'élément du tableau correspondant à l'index donné. Si l'index spécifié n'est pas trouvé, il renvoie undefined.
Lorsqu'on passe un nombre non négatif, la méthode at() est équivalente à la notation entre crochets. Par exemple, array
La pratique habituelle consiste à accéder à length et à soustraire l'index relatif à partir de la fin. Par exemple, array[array.length - 1]. La méthode at() permet l'indexation relative, de sorte que l'exemple ci-dessus peut être simplifié en array.at(-1). Plus formellement, lorsque index < 0, la méthode accède à l'index index + array.length.
La méthode at() est générique. Elle s'attend uniquement à ce que this possède une propriété length et des propriétés avec des clés entières.
Prise en charge des navigateurs
Les nombres dans le tableau spécifient la première version de navigateur qui prend entièrement en charge la méthode.
| Méthode | |||||
|---|---|---|---|---|---|
| at() | 45.0 | 12.0 | 32.0 | 9 | 25.0 |
Syntaxe
at(index)
Parameters
| Paramètre | Description |
| index | L'index (position) de l'élément du tableau à renvoyer. Lorsqu'un nombre négatif est passé, l'indexation relative depuis la fin du tableau est prise en charge ; c'est-à-dire que si un nombre négatif est utilisé, l'élément renvoyé sera compté à rebours depuis la fin du tableau. |
Détails techniques
| Valeur de retour : | Élément. |
| Version JavaScript : | ECMAScript 6 |
Plus d’exemples
Renvoie la dernière valeur d'un tableau :L'exemple suivant fournit une fonction qui renvoie le dernier élément trouvé dans un tableau spécifié.
Exemple
const cart = ['apple', 'banana', 'pear'];
// Une fonction pour retourner le dernier élément d'un tableau donné
function returnLast(arr) {
return arr.at(-1);
}
// Obtenir le dernier élément du tableau 'cart'
const item1 = returnLast(cart);
console.log(item1); // Sortie : 'pear'
// Ajouter un élément au tableau 'cart'
cart.push('orange');
const item2 = returnLast(cart);
console.log(item2); // Sortie : 'orange'
Comparez différentes méthodes de tableau :L'exemple suivant compare différentes façons de sélectionner l'avant-dernier élément d'un tableau. Bien que toutes les méthodes présentées ci-dessous soient valides, cet exemple met en évidence la concision et la lisibilité de la méthode at().
Exemple
const colors = ['red', 'green', 'blue'];
// Utilisation de la propriété length
const lengthWay = colors[colors.length-2];
console.log(lengthWay); // Sortie : 'green'
// Utilisation de la méthode slice(). Notez qu'elle renvoie un tableau
const sliceWay = colors.slice(-2, -1);
console.log(sliceWay[0]); // Sortie : 'green'
// Utilisation de la méthode at()
const atWay = colors.at(-2);
console.log(atWay); // Sortie : 'green'
Appel de at() sur des objets non-tableaux: La méthode at() lit la propriété length de this et calcule l'index à accéder.
Exemple
longueur: 2,
0: "a",
1: "b",
};
console.log(Array.prototype.at.call(arrayLike, -1)); // "b"
Autres extensions
Objet Array JavaScript