CKTIS / JavaScript
Array.prototype.values : itérateur de valeurs
values renvoie un itérateur vivant qui lit les valeurs indexées successives, y compris undefined provenant des trous.
Version : ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
array.values()array.values() crée un itérateur de valeurs sans copier les éléments. Chaque next() lit l’indice courant et vérifie de nouveau length ; les modifications faites avant la visite d’une position peuvent donc être observées. Un résultat d’étape contient value et done ; une fois épuisé, l’itérateur le reste.
Les trous ne sont pas ignorés : la lecture normale d’un indice absent produit undefined. L’itérateur est lui-même itérable et Array.prototype[Symbol.iterator] désigne initialement la même fonction que values. La méthode ne modifie rien et est générique pour array-like.
La création exige un receveur autre que null ou undefined, sinon elle lève TypeError. Conversion de length, getters indexés et traps de proxy ont lieu pendant l’itération ; leurs erreurs sortent donc de next(). L’API date d’ECMAScript 2015.
Exemples
const sparse = ["build", , "deploy"];
const iterator = sparse.values();
for (let step = iterator.next(); !step.done; step = iterator.next()) {
console.log(String(step.value), step.done);
}
console.log(iterator.next().done);
const tasks = ["test"];
const live = tasks.values();
console.log(live.next().value);
tasks.push("release");
console.log(live.next().value, live.next().done);Résultat
build false undefined false deploy false true test release true