Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Array.prototype.at : élément par indice relatif

La méthode at lit un élément du tableau et permet à un indice négatif de compter depuis la fin sans calculer length.

Version : ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntaxe

array.at(index)

array.at(index) convertit index en entier en tronquant sa partie fractionnaire. Un indice positif compte depuis le début ; un indice négatif est relatif à array.length, donc -1 désigne le dernier élément. La méthode est générique pour les objets array-like et ne les modifie pas.

Si l’indice calculé est hors limites, elle renvoie undefined sans lire la propriété. Un trou produit aussi undefined. NaN agit comme l’indice 0, tandis que Infinity est hors limites.

Un receveur null ou undefined lève TypeError. Contrairement à array[-1], qui cherche la propriété "-1", at(-1) compte réellement depuis la fin. L’exemple couvre indice négatif, hors limites et fractionnaire.

Exemples

const values = ["first", "middle", "last"];
console.log(values.at(-1));
console.log(values.at(-4));
console.log(values.at(1.9));

Résultat

last
undefined
middle

Sources