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

CKTIS / JavaScript

WeakMap.prototype.delete() — eliminar una entrada

Llama a `weakMap.delete(key)` para eliminar la entrada asociada a una clave. Devuelve `true` si eliminó una entrada y `false` si no lo hizo.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

weakMap.delete(key)

WeakMap.delete es una forma abreviada de nombrar el método de instancia WeakMap.prototype.delete. Llámalo como weakMap.delete(key), no como método estático del constructor WeakMap. Elimina la asociación entre la clave y el valor solo de ese mapa. A diferencia del operador delete, no elimina propiedades de un objeto.

true indica que la entrada existía y se eliminó, aunque su valor fuera undefined. Si la entrada no existe, el resultado es false. Las claves que son objetos se comparan por identidad: dos objetos distintos con las mismas propiedades no coinciden. Tras la eliminación, weakMap.has(key) devuelve false, salvo que vuelvas a añadir una entrada para esa clave.

ECMAScript 2024 admite como claves objetos y símbolos no registrados, como Symbol(), pero no símbolos obtenidos con Symbol.for(). La compatibilidad con claves de tipo símbolo depende del entorno de ejecución. En una instancia válida, delete() devuelve false si la clave no es válida, como una cadena, o si se omite el argumento; set() lanza TypeError si la clave no es válida. Llamar a delete() sin una instancia válida como this también lanza TypeError.

Un WeakMap no mantiene vivo un objeto por el mero hecho de que sea una clave. La eliminación explícita retira la entrada de inmediato, aunque el código conserve una referencia a la clave. No destruye el objeto ni fuerza la recolección de basura.

Ejemplos

{
  const notes = new WeakMap();
  const key = { id: 1 };
  notes.set(key, undefined);

  console.log(notes.delete({ id: 1 }));
  console.log(notes.delete(key));
  console.log(notes.has(key));
  console.log(notes.delete(key));
  console.log(notes.delete("id"));
}

Resultado

false
true
false
false
false

El objeto independiente `{ id: 1 }` no coincide con `key`. Eliminar con `key` devuelve `true` aunque el valor almacenado sea `undefined`. Después, `has()`, un segundo borrado y un intento de borrado con una cadena como clave devuelven `false`.

Lecciones relacionadas

  • JavaScript · Lección 18 · Básico · Versión: 4

Fuentes