CKTIS / JavaScript
Set.prototype.keys() — un itérateur sur les valeurs d’un ensemble
Set.prototype.keys() renvoie un nouvel itérateur sur les valeurs d’un ensemble, dans leur ordre d’insertion. Il ne renvoie ni index ni tableau : dans un Set, les clés et les valeurs désignent les mêmes éléments.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
set.keys()set.keys() ne nécessite aucun argument et renvoie un nouvel itérateur sur les valeurs de l’ensemble, dans leur ordre d’insertion. Un Set ne possède pas de clés ni d’index distincts. Dans la bibliothèque standard non modifiée, Set.prototype.keys et Set.prototype.values désignent la même fonction ; le nom keys assure la cohérence avec l’interface Map.
L’itérateur n’est pas un tableau. L’appel de next() le fait avancer d’un élément, tandis que [...iterator] rassemble ses éléments restants dans un tableau. Une fois l’itérateur épuisé, next() renvoie un résultat avec done: true. Un nouvel appel à set.keys() crée un itérateur indépendant.
L’itérateur n’est pas un instantané : un élément supprimé avant d’être visité est ignoré, et un élément ajouté avant la fin de l’itération peut être visité. Appeler la méthode avec une valeur this dépourvue des données internes d’un Set déclenche une TypeError.
Dans l’exemple, la répétition de "red" ne crée pas de second élément. Le premier appel à next() récupère "red" ; l’itérateur ne contient donc plus que "blue" lorsqu’il est déployé.
Exemples
const colors = new Set(["red", "blue", "red"]);
const iterator = colors.keys();
console.log(Set.prototype.keys === Set.prototype.values);
console.log(iterator.next().value);
console.log([...iterator].join(","));
console.log(iterator.next().done);Résultat
true red blue true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.