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