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