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

CKTIS / JavaScript

Set.prototype.entries() — un itérateur de paires de valeurs

Set.prototype.entries() renvoie un itérateur de paires [value, value] dans l’ordre d’insertion. La première position n’est pas un index : Set ne stocke pas de clés distinctes. L’itérateur peut être parcouru avec next(), for...of ou la syntaxe de décomposition.

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.entries()

Set.prototype.entries() ne prend aucun argument et renvoie un nouvel itérateur. Chaque élément produit est un nouveau tableau de deux éléments [value, value]. Les deux positions contiennent la même valeur ; pour un objet, elles référencent le même objet et non des copies. Ce format correspond aux paires renvoyées par Map.prototype.entries(), mais un Set ne possède ni clés ni index distincts.

Les éléments sont parcourus dans leur ordre d’insertion. set.values() et l’itération par défaut sur set produisent des valeurs individuelles, tandis que set.entries() produit des paires. La méthode exige un récepteur doté de données internes de Set ; l’appeler sur un objet ordinaire déclenche une TypeError.

L’itérateur n’est pas un instantané : il ignore les éléments supprimés avant d’être parcourus et peut inclure ceux qui sont ajoutés avant la fin de l’itération. La lecture consomme l’itérateur ; une fois épuisé, les appels suivants à next() renvoient done: true. La méthode ne modifie pas elle-même le set.

Dans l’exemple, la répétition de "red" ne crée pas un autre élément du set. Le premier appel à next() récupère la paire correspondant à "red", et [...iterator] rassemble uniquement la paire restante pour "blue".

Exemples

const set = new Set(["red", "blue", "red"]);
const iterator = set.entries();

console.log(JSON.stringify(iterator.next().value));
console.log(JSON.stringify([...iterator]));
console.log(iterator.next().done);

Résultat

["red","red"]
[["blue","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