CKTIS / JavaScript
Set.prototype.clear() — alle elementen verwijderen
Set.prototype.clear() verwijdert alle elementen uit een bestaande Set en retourneert undefined. De methode wijzigt hetzelfde object, zodat elke verwijzing naar dat object de lege collectie ziet.
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.clear()Roep Set.prototype.clear() aan als set.clear(), zonder argumenten. De methode verwijdert alle elementen; daarna is set.size 0. Ook wanneer je de methode op een lege Set aanroept, retourneert deze undefined en blijft de Set leeg.
De methode wijzigt het bestaande object in plaats van een nieuw object te maken. Andere variabelen die naar die Set verwijzen, zien ook een lege collectie. new Set() aan één variabele toewijzen is niet hetzelfde: andere verwijzingen wijzen nog steeds naar het vorige object.
In tegenstelling tot set.delete(value), dat één opgegeven element verwijdert en een booleaanse waarde retourneert, verwijdert clear() alle elementen en retourneert deze undefined. Daarom kun je set.clear().add(value) niet gebruiken. Objecten uit de Set verwijderen verandert die objecten zelf niet.
De methode vereist een ontvanger met de interne slot [[SetData]]; Set.prototype.clear.call({}) veroorzaakt een TypeError. Dit is een functie uit de ECMAScript-standaardbibliotheek, geen Web-API. De taalspecificatie is geen browsercompatibiliteitstabel; controleer de beschikbaarheid in de doelomgeving.
Voorbeelden
const values = new Set([1, 2, 3]);
const alias = values;
const result = values.clear();
console.log(values.size);
console.log(alias === values);
console.log(alias.size);
console.log(result === undefined);Resultaat
0 true 0 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.