CKTIS / JavaScript
Map.prototype.delete : supprimer une entrée par clé
La méthode delete supprime l’entrée de Map correspondant à la clé fournie et renvoie true uniquement si cette entrée existait.
Version : ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
map.delete(key)map.delete(key) recherche la clé sans conversion de type. Si une entrée existe, elle marque son enregistrement vide et renvoie true ; sinon la Map reste inchangée et elle renvoie false. La paire clé–valeur entière est supprimée et size ne diminue d’une unité qu’après une suppression réussie.
Les clés suivent SameValueZero : NaN correspond à NaN et -0 à +0 ; les objets ne correspondent que par identité de référence. L’ordre des autres entrées ne change pas. Un set ultérieur de la même clé crée un nouvel enregistrement à la fin de l’ordre d’itération et les itérateurs actifs sautent l’ancien enregistrement.
Le receveur doit être une vraie Map avec ses données internes ; un objet, un Set ou un Proxy non géré comme this lève TypeError. La méthode est standard depuis ECMAScript 2015. Son résultat booléen distingue une clé absente d’une entrée existante dont la valeur était undefined.
Exemples
const token = {};
const map = new Map([[token, "active"], [NaN, "unknown"], ["tail", 3]]);
console.log(map.delete({}), map.size);
console.log(map.delete(token), map.has(token), map.size);
console.log(map.delete(NaN), map.delete(NaN));
const ordered = new Map([["a", 1], ["b", 2]]);
ordered.delete("a");
ordered.set("a", 3);
console.log([...ordered.keys()].join(","));
try {
Map.prototype.delete.call({}, "a");
} catch (error) {
console.log(error instanceof TypeError);
}Résultat
false 3 true false 2 true false b,a true