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

CKTIS / JavaScript

WeakMap.set(): añadir o reemplazar un valor

Usa `set()` para guardar un valor asociado a una clave en un `WeakMap`. Si la clave ya existe, se reemplaza su valor. El método devuelve el mismo mapa para que puedas encadenar llamadas.

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

Sintaxis

weakMap.set(key, value)

WeakMap.set se refiere al método de instancia WeakMap.prototype.set, no a un método estático del constructor WeakMap. weakMap.set(key, value) añade una entrada si la clave es nueva o reemplaza el valor si la clave ya existe. Devuelve el mismo WeakMap, así que puedes encadenar otra llamada a .set(). Se admite cualquier valor; si omites value, se guarda undefined.

Las claves que son objetos se comparan por identidad: dos objetos {} creados por separado son claves distintas. ECMAScript 2024 también admite símbolos no registrados como Symbol(). Los entornos de ejecución antiguos pueden admitir solo objetos como claves. Si usas como clave una cadena, un número, null o un símbolo registrado mediante Symbol.for(), se lanza un TypeError. Lo mismo ocurre si llamas al método con un this que no es una instancia de WeakMap.

Una entrada no mantiene viva su clave por sí sola. Si la clave deja de ser accesible fuera de esa asociación débil, el recolector de basura puede recuperarla, pero no se garantiza cuándo. Esto permite almacenar datos adicionales sobre un objeto sin prolongar su vida. Usa Map si necesitas claves de texto o recorrer las entradas.

Ejemplos

{
  const statuses = new WeakMap();
  const task = {};
  const otherTask = {};

  const result = statuses.set(task, "pending").set(otherTask, false);
  statuses.set(task, "ready");

  console.log(result === statuses);
  console.log(statuses.get(task));
  console.log(statuses.get(otherTask));
  console.log(statuses.has({}));

  try {
    statuses.set("task", "ready");
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Resultado

true
ready
false
false
true

El primer `true` muestra que las llamadas encadenadas devuelven el mismo mapa. `ready` reemplaza a `pending`. El primer `false` es el valor guardado para `otherTask`; el segundo indica que el nuevo `{}` no es una clave del mapa. El último `true` confirma que la clave de texto provocó un `TypeError`.

Lecciones relacionadas

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

Fuentes