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

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