KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen