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

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.

Sources