Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Set.prototype.delete — supprimer une valeur d’un ensemble

Set.prototype.delete(value) supprime la valeur indiquée d’un ensemble existant. La méthode renvoie true si la suppression a eu lieu, ou false si la valeur était absente. Les objets sont comparés selon leur identité, et non selon leur contenu.

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.delete(value)

set.delete(value) modifie un Set existant : la méthode supprime la valeur correspondante et renvoie true. Si la valeur est absente, elle renvoie false sans modifier l’ensemble. L’argument désigne une valeur, pas un indice. Le résultat est un booléen, et non l’ensemble ; il n’est donc pas possible d’enchaîner plusieurs appels à .delete().

La comparaison suit la sémantique SameValueZero : NaN correspond à NaN, et +0 et -0 sont considérés comme la même valeur. Les objets sont comparés selon leur identité. Un nouvel objet { id: 1 } ne correspond pas à un objet ajouté précédemment ayant les mêmes champs ; il faut transmettre une référence vers le même objet.

Ne confondez pas cette méthode avec l’opérateur delete, qui supprime des propriétés d’objets, ni avec set.clear(), qui supprime tous les éléments. La méthode nécessite un récepteur contenant les données internes d’un Set ; l’appel Set.prototype.delete.call({}, value) déclenche un TypeError. Il s’agit d’une API du langage ECMAScript, et non d’une API de navigateur ; la seule présence de Node.js dans un projet ne confirme pas la prise en charge par les navigateurs ciblés.

Exemples

const item = { id: 1 };
const values = new Set(["ready", item, NaN]);

console.log(values.delete("ready"));
console.log(values.delete("ready"));
console.log(values.delete({ id: 1 }));
console.log(values.delete(item));
console.log(values.delete(NaN));
console.log(values.size);

Résultat

true
false
false
true
true
0

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.

Sources