Méthode at()de JavaScript

Array 对象参考手册Objet Array JavaScript

Exemple

Prend une valeur entière et renvoie l'élément à cet index :

const array1 = [5, 12, 8, 130, 44]; let index1 = 2; strt1= `L'index est ${index1}et la valeur est ${array1.at(index1)}`; document.getElementById("demo1").innerHTML = strt1; let index2 = -2; strt2= `L'index est ${index2}et la valeur est ${array1.at(index2)}`; document.getElementById("demo2").innerHTML = strt2;

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

// Tableau et éléments de tableau
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

// Tableau et éléments de tableau
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

const arrayLike = {
  longueur: 2,
  0: "a",
  1: "b",
};
console.log(Array.prototype.at.call(arrayLike, -1)); // "b"


Array 对象参考手册Objet Array JavaScript

Autres extensions