CKTIS / JavaScript
Set.prototype.add — een waarde aan een verzameling toevoegen
Set.prototype.add(value) voegt één waarde toe aan een verzameling als die er nog niet in staat. De methode wijzigt de bestaande Set en geeft hetzelfde object terug, zodat aanroepen kunnen worden gekoppeld.
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.add(value)set.add(value) voegt één waarde toe aan een bestaand Set-object. Staat de waarde er al in, dan blijft de verzameling onveranderd. De methode geeft altijd dezelfde verzameling terug, en geen boolean die aangeeft of er iets is toegevoegd. Daarom kun je set.add(a).add(b) schrijven. Een nieuwe waarde komt aan het einde van de iteratievolgorde; een bestaande waarde opnieuw toevoegen verandert haar positie niet.
Uniciteit volgt de vergelijking SameValueZero: NaN is een duplicaat van NaN, en -0 en +0 staan voor hetzelfde element; nul wordt opgeslagen als +0. Objecten worden vergeleken op identiteit, niet op inhoud. Twee afzonderlijk gemaakte {}-objecten zijn dus verschillende elementen, maar dezelfde verwijzing opnieuw toevoegen verhoogt size niet.
add vouwt arrays of andere iterables niet uit: set.add([1, 2]) voegt één array toe. Aanroepen zonder argument voegt undefined toe. De methode vereist een ontvanger met interne Set-gegevens; Set.prototype.add.call({}, 1) veroorzaakt een TypeError.
Voorbeelden
const values = new Set();
const returned = values.add("blue").add("green").add("blue");
console.log(returned === values);
console.log(values.size);
console.log([...values].join(","));
values.add(NaN).add(NaN).add(-0).add(+0);
console.log(values.size);Resultaat
true 2 blue,green 4
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.