Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Map.prototype.delete: eliminar una entrada por clave

El método delete elimina la entrada de Map que coincide con la clave indicada y devuelve true solo si dicha entrada existía.

Versión: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxis

map.delete(key)

map.delete(key) busca la clave sin conversión de tipo. Si existe una entrada, marca vacío ese registro y devuelve true; de lo contrario deja el Map sin cambios y devuelve false. Se elimina el par clave–valor completo y size solo disminuye en uno tras una eliminación correcta.

Las claves usan SameValueZero: NaN coincide con NaN y -0 con +0; los objetos solo coinciden por identidad de referencia. El orden de las entradas restantes no cambia. Un set posterior de la misma clave crea un registro nuevo al final del orden de iteración y los iteradores activos omiten el registro eliminado.

El receptor debe ser un Map real con datos internos de Map; usar un objeto, Set o Proxy no gestionado como this lanza TypeError. El método es estándar desde ECMAScript 2015. Su resultado booleano distingue una clave ausente de una entrada existente cuyo valor era undefined.

Ejemplos

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

Fuentes