CKTIS / JavaScript
WeakMap.prototype.delete() : supprimer une entrée par sa clé
Supprimez une entrée d’une `WeakMap` et utilisez le résultat booléen pour savoir si une entrée a bien été supprimée.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
weakMap.delete(key)WeakMap.prototype.delete est une méthode d’instance. L’appel weakMap.delete(key) supprime l’entrée associée à key dans cette collection. La méthode renvoie true uniquement si elle a supprimé une entrée existante, même si la valeur stockée était undefined. En l’absence d’entrée, elle renvoie false.
Les clés sont comparées par identité : deux objets distincts ayant les mêmes propriétés sont des clés différentes. ECMAScript 2024 accepte les objets et les symboles non enregistrés, comme ceux créés avec Symbol(). La prise en charge des symboles comme clés dépend de l’environnement d’exécution. Pour une clé non valide, comme une chaîne de caractères ou un symbole obtenu avec Symbol.for(), delete() renvoie false, tandis que set() lève une exception TypeError. Un appel avec un this non valide, tel que WeakMap.prototype.delete.call({}, key), lève également une exception TypeError.
La méthode supprime immédiatement l’association. Elle ne modifie pas l’objet servant de clé, ne supprime aucune de ses propriétés comme le ferait l’opérateur delete et ne force pas le ramasse-miettes à s’exécuter. Utilisez-la lorsque l’association stockée n’est plus nécessaire, mais que la clé reste accessible.
Exemples
{
const weakMap = new WeakMap();
const key = { id: 1 };
weakMap.set(key, undefined);
console.log(weakMap.delete({ id: 1 }));
console.log(weakMap.delete(key));
console.log(weakMap.has(key));
console.log(weakMap.delete(key));
console.log(weakMap.delete("id"));
}Résultat
false true false false false
Le nouvel objet `{ id: 1 }` ne correspond pas à la clé stockée. La clé d’origine `key` permet de supprimer l’entrée même si sa valeur est `undefined`. Le test avec `has()`, la seconde suppression et la tentative avec une chaîne comme clé renvoient tous `false`.
Leçons associées
- JavaScript · Leçon 35 · Débutant · Version : 4
- JavaScript · Leçon 37 · Débutant · Version : 4
- JavaScript · Leçon 4 · Intermédiaire · Version : 3
- JavaScript · Leçon 10 · Intermédiaire · Version : 3
Sources
- ECMAScript 2024 Language Specification — WeakMap.prototype.delete (key)
- ECMAScript Language Specification — WeakMap.prototype.delete (key)
- ECMAScript 2024 Language Specification — CanBeHeldWeakly (v)
- ECMAScript 2024 Language Specification — WeakMap Objects
- ECMAScript 2024 Language Specification — The delete Operator
- MDN — WeakMap.prototype.delete()
- MDN — WeakMap browser compatibility