CKTIS / JavaScript
Set.prototype.keys() — een iterator over Set-waarden
Set.prototype.keys() retourneert een nieuwe iterator over de waarden van een Set, in de volgorde waarin ze zijn toegevoegd. De methode retourneert geen indexen of array: in een Set verwijzen sleutels en waarden naar dezelfde elementen.
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.keys()set.keys() heeft geen argumenten nodig en retourneert een nieuwe iterator over de waarden van de Set, in de volgorde waarin ze zijn toegevoegd. Een Set heeft geen afzonderlijke sleutels of indexen. In de ongewijzigde standaardbibliotheek verwijzen Set.prototype.keys en Set.prototype.values naar dezelfde functie; de naam keys zorgt voor consistentie met de Map-interface.
De iterator is geen array. Een aanroep van next() gaat één element verder, terwijl [...iterator] de resterende elementen in een array verzamelt. Als de iterator is uitgeput, retourneert next() een resultaat met done: true. Een nieuwe aanroep van set.keys() maakt een onafhankelijke iterator.
De iterator is geen momentopname: een element dat wordt verwijderd voordat het wordt bezocht, wordt overgeslagen; een element dat wordt toegevoegd voordat de iteratie is afgelopen, kan worden bezocht. Als de methode wordt aangeroepen met een this-waarde zonder de interne Set-gegevens, wordt een TypeError gegooid.
In het voorbeeld maakt de herhaling van "red" geen tweede element aan. De eerste aanroep van next() haalt "red" op, zodat na het uitspreiden van de iterator alleen "blue" overblijft.
Voorbeelden
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);Resultaat
true red blue true
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.