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

CKTIS / JavaScript

WeakMap.prototype.delete() — supprimer une entrée

Appelez `weakMap.delete(key)` pour supprimer l’entrée associée à une clé. La méthode renvoie `true` si elle a supprimé une entrée et `false` dans le cas contraire.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

weakMap.delete(key)

WeakMap.delete est un nom abrégé pour la méthode d’instance WeakMap.prototype.delete. Appelez-la sous la forme weakMap.delete(key), et non comme une méthode statique du constructeur WeakMap. Elle retire l’association entre la clé et la valeur de cette map seulement. Contrairement à l’opérateur delete, elle ne supprime pas de propriété d’un objet.

true indique qu’une entrée existait et a été supprimée, même si sa valeur était undefined. Si l’entrée est absente, le résultat est false. Les clés objets sont comparées par identité : deux objets distincts ayant les mêmes propriétés ne correspondent pas. Après la suppression, weakMap.has(key) renvoie false, sauf si une entrée est ajoutée à nouveau pour cette clé.

ECMAScript 2024 accepte comme clés les objets et les symboles non enregistrés tels que Symbol(), mais pas les symboles issus de Symbol.for(). La prise en charge des clés symboliques dépend de l’environnement d’exécution. Sur une instance valide, delete() renvoie false si la clé est invalide, par exemple une chaîne, ou si l’argument est omis. set() lève une TypeError pour une clé invalide. Un appel à delete() sans instance valide comme this lève aussi une TypeError.

Une WeakMap ne maintient pas un objet en vie simplement parce qu’il sert de clé. La suppression explicite retire l’entrée immédiatement, même si le code conserve une référence à la clé. Elle ne détruit pas l’objet et ne force pas le ramasse-miettes à intervenir.

Exemples

{
  const notes = new WeakMap();
  const key = { id: 1 };
  notes.set(key, undefined);

  console.log(notes.delete({ id: 1 }));
  console.log(notes.delete(key));
  console.log(notes.has(key));
  console.log(notes.delete(key));
  console.log(notes.delete("id"));
}

Résultat

false
true
false
false
false

L’objet distinct `{ id: 1 }` ne correspond pas à `key`. La suppression avec `key` renvoie `true` même si la valeur stockée est `undefined`. Ensuite, `has()`, une seconde suppression et une tentative avec une clé de type chaîne renvoient chacun `false`.

Leçons associées

  • JavaScript · Leçon 18 · Débutant · Version : 4

Sources