CKTIS / JavaScript
Map.prototype.clear: eliminar todas las entradas
El método clear elimina in situ todos los pares clave–valor de un Map, deja su tamaño observable en cero y devuelve undefined.
Versión: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxis
map.clear()map.clear() marca como vacía cada entrada existente del Map sin crear una colección nueva. Después, size es 0 y has, get y la iteración no observan las claves eliminadas. El método no admite argumentos significativos y siempre devuelve undefined, por lo que no se puede encadenar como set.
Los iteradores existentes no se sustituyen. Omiten los registros borrados, pero un iterador que aún no terminó con done: true puede ver entradas añadidas al mismo Map después de clear, porque los registros nuevos se anexan a la secuencia interna. Limpiar elimina las referencias del Map, pero recuperar memoria depende de otras referencias y del recolector de basura.
El método exige un receptor con datos internos de Map; Map.prototype.clear.call({}), un Set o un Proxy no gestionado que envuelva un Map lanza TypeError. Es estándar desde ECMAScript 2015. Úselo para conservar la identidad de un Map observado en otros lugares; map = new Map() solo cambia esa referencia local.
Ejemplos
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