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

CKTIS / JavaScript

Array.prototype.keys : itérateur des indices

keys renvoie un itérateur d’indices consécutifs depuis zéro, y compris pour les trous.

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

Syntaxe

array.keys()

array.keys() renvoie un nouvel itérateur des indices 0, 1, …. Il ne lit pas les valeurs et ne teste pas l’existence de la propriété, donc un trou reçoit un indice normal. L’itérateur est à usage unique, lui-même itérable et ne modifie pas le receveur.

La longueur courante est vérifiée à chaque next() et non figée à la création. Un élément ajouté avant la fin peut donc ajouter un indice ; raccourcir le tableau peut terminer plus tôt. La méthode est générique pour les receveurs array-like, mais null/undefined lève TypeError. L’exemple montre les indices de trous et un indice ajouté pendant l’itération.

Exemples

console.log([...new Array(3).keys()].join(","));
const values = ["A"];
const iterator = values.keys();
console.log(iterator.next().value);
values.push("B");
const appended = iterator.next();
console.log(appended.value, appended.done);

Résultat

0,1,2
0
1 false

Sources