CKTIS / JavaScript
Set.prototype.values() — iterator over de waarden van een verzameling
De methode values() geeft een nieuwe iterator over de waarden van een Set terug, in de volgorde waarin ze zijn toegevoegd. De methode maakt geen array of kopie van de verzameling; elke uitlezing verplaatst de iterator, en wijzigingen aan de verzameling kunnen het resterende verloop beïnvloeden.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
set.values()Roep Set.prototype.values() zonder argumenten aan als set.values(). De methode geeft een nieuwe iterator over de waarden in de volgorde waarin ze zijn toegevoegd terug, geen array. De aanroep zelf verandert de verzameling niet. Een bestaande waarde opnieuw toevoegen maakt geen duplicaat en verandert de positie niet.
De methode next() van de iterator geeft een object met de eigenschappen value en done terug. Wanneer de iterator is uitgeput, zijn deze respectievelijk undefined en true; volgende aanroepen starten het verloop niet opnieuw. Voor een nieuw verloop moet je set.values() opnieuw aanroepen. De iterator ondersteunt for...of en [...iterator], waarmee de resterende elementen worden verbruikt.
De iterator is geen momentopname: waarden die worden verwijderd voordat ze aan de beurt zijn, worden overgeslagen; waarden die vóór het einde van het verloop worden toegevoegd, kunnen worden bezocht. Een waarde verwijderen en opnieuw toevoegen plaatst die achteraan. Daardoor kan de waarde opnieuw worden bezocht als de eerdere vermelding al is gelezen. Voeg tijdens iteratie niet ongecontroleerd waarden toe.
Standaard verwijzen Set.prototype.keys en Set.prototype[Symbol.iterator] naar dezelfde functie als Set.prototype.values. entries() geeft daarentegen paren [value, value] terug. values() vereist een ontvanger met interne Set-gegevens; de methode aanroepen op een gewoon object of een array veroorzaakt een TypeError.
Voorbeelden
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()]));Resultaat
{"value":"a","done":false}
["b"]
{"done":true}
["a","b"]De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.