Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes