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

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

Sources