CKTIS / JavaScript
Set.prototype.clear() — supprimer tous les éléments
Set.prototype.clear() supprime tous les éléments d’un Set existant et renvoie undefined. La méthode modifie le même objet : toutes les références vers cet objet voient donc la collection vidée.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
set.clear()Appelez Set.prototype.clear() sous la forme set.clear(), sans argument. La méthode supprime tous les éléments ; ensuite, set.size vaut 0. Appelée sur un Set vide, elle renvoie également undefined et le laisse vide.
La méthode modifie l’objet existant au lieu d’en créer un nouveau. Les autres variables qui référencent ce Set voient elles aussi une collection vide. Affecter new Set() à une variable n’est pas équivalent : les autres références pointent toujours vers l’objet précédent.
Contrairement à set.delete(value), qui supprime un élément donné et renvoie une valeur booléenne, clear() supprime tous les éléments et renvoie undefined. Il n’est donc pas possible d’utiliser set.clear().add(value). Retirer des objets du Set ne modifie pas ces objets eux-mêmes.
La méthode exige un récepteur doté du slot interne [[SetData]] ; Set.prototype.clear.call({}) déclenche une TypeError. Il s’agit d’une fonctionnalité de la bibliothèque standard ECMAScript, et non d’une API Web. La spécification du langage n’est pas un tableau de compatibilité des navigateurs ; vérifiez la disponibilité dans l’environnement cible.
Exemples
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);Résultat
0 true 0 true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.