CKTIS / JavaScript
Set.prototype.forEach — een callback uitvoeren voor setwaarden
Set.prototype.forEach roept een functie aan voor setwaarden in invoegvolgorde. De methode geeft de waarde twee keer en de set zelf door, en retourneert undefined.
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.forEach(callback[, thisArg])
callback(value, valueAgain, set)Set.prototype.forEach roept callback aan voor setwaarden in invoegvolgorde. De methode retourneert undefined; ze maakt geen nieuwe set aan en negeert waarden die de callback retourneert.
De argumenten van de callback zijn (value, valueAgain, set): de eerste twee bevatten dezelfde waarde en het derde is de set waarover wordt geïtereerd. Het tweede argument is geen index. Het optionele thisArg wordt als this van de callback meegegeven; een arrowfunctie behoudt zijn lexicale this.
De iteratie houdt rekening met wijzigingen: waarden die vóór hun bezoek worden verwijderd, worden overgeslagen en nieuwe waarden die vóór het einde worden toegevoegd, worden bezocht. Een waarde die al is bezocht, daarna wordt verwijderd en opnieuw wordt toegevoegd, kan nogmaals worden bezocht. Zulke wijzigingen kunnen voorkomen dat de iteratie eindigt.
return beëindigt alleen de huidige aanroep van de callback, niet de hele iteratie. Gebruik for...of wanneer je break nodig hebt. Een uitzondering stopt de iteratie. Een incompatibele ontvanger zonder interne Set-gegevens of een niet-aanroepbare callback veroorzaakt een TypeError.
Voorbeelden
const values = new Set([3, 1, 3]);
const lines = [];
const result = values.forEach((value, valueAgain, set) => {
lines.push(`${value}|${valueAgain}|${set === values}`);
});
console.log(lines.join('\n'));
console.log(String(result));Resultaat
3|3|true 1|1|true undefined
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.