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

CKTIS / JavaScript

WeakMap.prototype.set(): guardar un valor asociado a una clave

`set()` añade una entrada a un `WeakMap` o reemplaza el valor de una clave existente. Devuelve la misma instancia, lo que permite encadenar llamadas.

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

Sintaxis

weakMap.set(key, value)

WeakMap.prototype.set es un método del prototipo que se invoca sobre una instancia: weakMap.set(key, value). Añade una entrada para una clave nueva o sustituye el valor asociado a la misma clave. Devuelve la propia instancia, no el valor almacenado, así que se puede encadenar otra llamada a .set(). El valor puede ser cualquier valor de JavaScript, incluido undefined.

Las claves que son objetos se comparan por identidad: dos objetos distintos con propiedades idénticas son claves diferentes. ECMAScript 2024 también admite símbolos no registrados como Symbol("id"). Los símbolos de Symbol.for("id") y otros valores primitivos, como las cadenas, no son claves válidas. Es posible que los entornos de ejecución antiguos no admitan claves de tipo símbolo; comprueba el entorno de destino.

Una clave no válida provoca un TypeError. Invocar el método separado de la instancia sin el this correcto también provoca un TypeError: el receptor debe ser una instancia de WeakMap.

La entrada no mantiene viva la clave por sí sola. Si la clave deja de ser accesible por otras vías, el recolector de basura puede eliminarla; no dependas del momento en que eso ocurra. Las claves de un WeakMap no se pueden enumerar. Si necesitas recorrer las claves o usar cadenas como claves, utiliza un Map.

Ejemplos

{
  const metadata = new WeakMap();
  const item = { id: 1 };

  metadata.set(item, 10);
  console.log(metadata.get(item));

  const returned = metadata.set(item, 20);
  console.log(returned === metadata);
  console.log(metadata.get(item));
  console.log(metadata.has({ id: 1 }));

  try {
    metadata.set("id", 30);
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Resultado

10
true
20
false
true

La primera consulta devuelve `10`; después de actualizar el valor, devuelve `20`. La comparación `returned === metadata` da `true`. Un objeto nuevo con el mismo `id` no es la clave almacenada, por lo que `has()` devuelve `false`. El intento de usar una cadena como clave provoca un `TypeError`, que se captura.

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