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

CKTIS / JavaScript

Map.prototype.clear: remover todas as entradas

O método clear remove no próprio Map todos os pares chave–valor, torna zero o tamanho observado e devolve undefined.

Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxe

map.clear()

map.clear() marca como vazia cada entrada existente do Map sem criar uma coleção nova. Depois, size é 0 e has, get e a iteração não observam as chaves removidas. O método não aceita argumentos significativos e devolve sempre undefined, pelo que não pode ser encadeado como set.

Os iteradores existentes não são substituídos. Ignoram registos apagados, mas um iterador que ainda não terminou com done: true pode ver entradas adicionadas ao mesmo Map após clear, pois os registos novos são acrescentados à sequência interna. Limpar remove as referências do Map, mas a recuperação da memória depende de outras referências e do garbage collector.

O método exige um recetor com dados internos de Map; Map.prototype.clear.call({}), um Set ou um Proxy não tratado que envolva um Map lança TypeError. É padrão desde ECMAScript 2015. Use-o para preservar a identidade de um Map observado noutros locais; map = new Map() altera apenas essa referência local.

Exemplos

const map = new Map([["a", 1], ["b", 2]]);
const keys = map.keys();
console.log(keys.next().value);

const result = map.clear();
console.log(result === undefined, map.size);

map.set("c", 3);
const afterClear = keys.next();
console.log(afterClear.value, afterClear.done);

try {
  Map.prototype.clear.call({});
} catch (error) {
  console.log(error instanceof TypeError);
}

Resultado

a
true 0
c false
true

Fontes