CKTIS / JavaScript
Map.prototype.delete: remover uma entrada por chave
O método delete remove a entrada de Map correspondente à chave fornecida e devolve true apenas quando essa entrada existia.
Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxe
map.delete(key)map.delete(key) procura a chave sem conversão de tipo. Se existir uma entrada, marca o registo como vazio e devolve true; caso contrário deixa o Map inalterado e devolve false. É removido o par chave–valor completo e size só diminui um após eliminação bem-sucedida.
As chaves usam SameValueZero: NaN corresponde a NaN e -0 a +0; objetos só correspondem por identidade da referência. A ordem das entradas restantes não muda. Um set posterior da mesma chave cria um registo novo no fim da ordem de iteração e iteradores ativos ignoram o registo eliminado.
O recetor tem de ser um Map real com dados internos de Map; usar objeto, Set ou Proxy não tratado como this lança TypeError. O método é padrão desde ECMAScript 2015. O resultado booleano distingue uma chave ausente de uma entrada existente cujo valor era undefined.
Exemplos
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);
}Resultado
false 3 true false 2 true false b,a true