Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti