CKTIS / JavaScript
WeakMap.prototype.delete(): eliminar una entrada por su clave
Elimina una entrada de un `WeakMap` y usa el valor booleano devuelto para saber si se ha eliminado alguna entrada.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
weakMap.delete(key)WeakMap.prototype.delete es un método de instancia. La llamada weakMap.delete(key) elimina de ese mapa la entrada asociada a key. Solo devuelve true si ha eliminado una entrada existente, aunque su valor almacenado fuera undefined. Si no hay ninguna entrada para la clave, devuelve false.
Las claves se comparan por identidad: dos objetos distintos con las mismas propiedades son claves diferentes. ECMAScript 2024 admite objetos y símbolos no registrados, como los creados con Symbol(). La compatibilidad con símbolos como claves varía según el entorno de ejecución. Si la clave no es válida, como una cadena o un símbolo obtenido con Symbol.for(), delete() devuelve false, mientras que set() lanza un TypeError. Una llamada con un this no válido, como WeakMap.prototype.delete.call({}, key), también lanza un TypeError.
El método elimina la asociación de inmediato. No modifica el objeto que sirve de clave, no elimina ninguna de sus propiedades como lo haría el operador delete ni fuerza la recolección de basura. Úsalo cuando ya no necesites la asociación almacenada, pero la clave siga disponible.
Ejemplos
{
const weakMap = new WeakMap();
const key = { id: 1 };
weakMap.set(key, undefined);
console.log(weakMap.delete({ id: 1 }));
console.log(weakMap.delete(key));
console.log(weakMap.has(key));
console.log(weakMap.delete(key));
console.log(weakMap.delete("id"));
}Resultado
false true false false false
El objeto nuevo `{ id: 1 }` no coincide con la clave almacenada. La clave original `key` permite eliminar la entrada aunque su valor sea `undefined`. La comprobación con `has()`, la segunda eliminación y el intento con una cadena como clave devuelven `false`.
Lecciones relacionadas
- JavaScript · Lección 35 · Básico · Versión: 4
- JavaScript · Lección 37 · Básico · Versión: 4
- JavaScript · Lección 4 · Intermedio · Versión: 3
- JavaScript · Lección 10 · Intermedio · Versión: 3
Fuentes
- ECMAScript 2024 Language Specification — WeakMap.prototype.delete (key)
- ECMAScript Language Specification — WeakMap.prototype.delete (key)
- ECMAScript 2024 Language Specification — CanBeHeldWeakly (v)
- ECMAScript 2024 Language Specification — WeakMap Objects
- ECMAScript 2024 Language Specification — The delete Operator
- MDN — WeakMap.prototype.delete()
- MDN — WeakMap browser compatibility