CKTIS / JavaScript
Map.prototype.delete: rimuovere una voce per chiave
Il metodo delete rimuove la voce Map corrispondente alla chiave fornita e restituisce true solo se tale voce esisteva.
Versione: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintassi
map.delete(key)map.delete(key) cerca la chiave senza conversione di tipo. Se una voce esiste, contrassegna il record come vuoto e restituisce true; altrimenti lascia invariata la Map e restituisce false. Viene rimossa l’intera coppia chiave–valore e size diminuisce di uno solo dopo una cancellazione riuscita.
Le chiavi usano SameValueZero: NaN corrisponde a NaN e -0 a +0; gli oggetti corrispondono solo per identità del riferimento. L’ordine delle voci restanti non cambia. Un successivo set della stessa chiave crea un nuovo record in fondo all’ordine di iterazione e gli iteratori attivi saltano il record cancellato.
Il ricevitore deve essere una vera Map con dati interni Map; usare un oggetto, Set o Proxy non gestito come this genera TypeError. Il metodo è standard da ECMAScript 2015. Il risultato booleano distingue una chiave assente da una voce esistente il cui valore era undefined.
Esempi
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);
}Risultato
false 3 true false 2 true false b,a true