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

CKTIS / JavaScript

Set.prototype.values() — l’itérateur des valeurs d’un ensemble

La méthode values() renvoie un nouvel itérateur sur les valeurs d’un Set, dans leur ordre d’insertion. Elle ne crée ni tableau ni copie de l’ensemble ; chaque lecture fait avancer l’itérateur, et les modifications de l’ensemble peuvent influer sur la suite du parcours.

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

Appelez Set.prototype.values() sous la forme set.values(), sans argument. La méthode renvoie un nouvel itérateur sur les valeurs dans leur ordre d’insertion, et non un tableau. L’appel ne modifie pas l’ensemble. Ajouter de nouveau une valeur déjà présente ne crée pas de doublon et ne change pas sa position.

La méthode next() de l’itérateur renvoie un objet avec les propriétés value et done. Une fois l’itérateur épuisé, elles valent respectivement undefined et true ; les appels suivants ne recommencent pas le parcours. Pour effectuer un nouveau parcours, il faut rappeler set.values(). L’itérateur prend en charge for...of et [...iterator], qui consomme les éléments restants.

L’itérateur n’est pas un instantané : il ignore les valeurs supprimées avant leur visite et peut parcourir celles qui sont ajoutées avant la fin du parcours. Supprimer puis ajouter de nouveau une valeur la place à la fin ; elle peut donc être visitée une nouvelle fois si son occurrence précédente a déjà été lue. Évitez les ajouts incontrôlés pendant l’itération.

Par défaut, Set.prototype.keys et Set.prototype[Symbol.iterator] font référence à la même fonction que Set.prototype.values. En revanche, entries() renvoie des paires [value, value]. values() exige un récepteur doté de données internes de Set ; l’appeler sur un objet ordinaire ou un tableau provoque un TypeError.

Exemples

const set = new Set(["a", "b", "a"]);
const iterator = set.values();

console.log(JSON.stringify(iterator.next()));
console.log(JSON.stringify([...iterator]));
console.log(JSON.stringify(iterator.next()));
console.log(JSON.stringify([...set.values()]));

Résultat

{"value":"a","done":false}
["b"]
{"done":true}
["a","b"]

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