CKTIS / JavaScript
Set.prototype.entries() — een iterator van waardeparen
Set.prototype.entries() retourneert een iterator met [value, value]-paren in invoegvolgorde. De eerste positie is geen index: Set slaat geen afzonderlijke sleutels op. Je kunt de iterator uitlezen met next(), for...of of de spread-syntaxis.
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.entries()Set.prototype.entries() accepteert geen argumenten en retourneert een nieuwe iterator. Elk opgeleverd element is een nieuwe array met twee elementen: [value, value]. Beide posities bevatten dezelfde waarde; bij een object verwijzen ze naar hetzelfde object en niet naar kopieën. Dit formaat komt overeen met de paren die Map.prototype.entries() retourneert, maar een Set heeft geen afzonderlijke sleutels of indexen.
De elementen worden in invoegvolgorde doorlopen. set.values() en de standaarditeratie over set leveren afzonderlijke waarden op, terwijl set.entries() paren oplevert. De methode vereist een ontvanger met interne Set-gegevens; een aanroep op een gewoon object veroorzaakt een TypeError.
De iterator is geen momentopname: hij slaat elementen over die zijn verwijderd voordat ze worden bezocht en kan elementen bevatten die zijn toegevoegd voordat de iteratie eindigt. Uitlezen verbruikt de iterator; na uitputting hebben volgende aanroepen van next() de waarde done: true. De methode wijzigt de set zelf niet.
In het voorbeeld maakt de herhaling van "red" geen extra set-element aan. De eerste aanroep van next() haalt het paar voor "red" op, en [...iterator] verzamelt alleen het overgebleven paar voor "blue".
Voorbeelden
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);Resultaat
["red","red"] [["blue","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.