CKTIS / JavaScript
WeakMap: leer, escribir y eliminar entradas
Aprende qué devuelven `get`, `set` y `delete`, qué claves admite `WeakMap` y cómo distinguir una entrada ausente de otra que almacena `undefined`.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const wm = new WeakMap();
wm.get(key);
wm.set(key, value);
wm.delete(key);get, set y delete son tres métodos de WeakMap.prototype. Se invocan sobre una instancia de WeakMap, como en wm.get(key), no como métodos estáticos del constructor. Una llamada sin una instancia adecuada o con un valor de this incompatible lanza un TypeError.
wm.get(key) devuelve el valor almacenado o undefined si la clave no está presente o no es válida. Usa wm.has(key) para distinguir una entrada ausente de un valor undefined almacenado. wm.set(key, value) añade una entrada o sustituye su valor. Acepta cualquier valor y devuelve la misma instancia, lo que permite encadenar llamadas. wm.delete(key) devuelve true si elimina una entrada y false si la clave no está presente o no es válida. El método elimina una entrada, no una propiedad de un objeto como hace el operador delete.
ECMAScript 2024 admite como claves objetos, incluidas las funciones, y símbolos no registrados, como los creados con Symbol(). Los símbolos registrados con Symbol.for() y los demás valores primitivos no son claves válidas; set lanza un TypeError en esos casos. Las claves se comparan por identidad: dos objetos distintos con las mismas propiedades son claves distintas. Comprueba si tu entorno de ejecución admite claves de tipo símbolo.
Usa WeakMap para asociar metadatos a un objeto sin mantenerlo vivo solo por usarlo como clave. La colección no conserva referencias fuertes a sus claves. No hay garantías sobre cuándo se recuperará la memoria y no se pueden enumerar las claves. Usa Map si necesitas recorrerlas.
Ejemplos
{
const metadata = new WeakMap();
const item = { id: 1 };
console.log(metadata.set(item, 1) === metadata);
metadata.set(item, 2);
console.log(metadata.get(item));
console.log(metadata.get({ id: 1 }));
metadata.set(item, undefined);
console.log(metadata.get(item) === undefined && metadata.has(item));
console.log(metadata.delete(item));
console.log(metadata.delete(item));
console.log(metadata.get(item));
}Resultado
true 2 undefined true true false undefined
`set` devuelve la misma colección y sustituye `1` por `2`. El nuevo objeto `{ id: 1 }` es una clave distinta. `has` confirma que existe la entrada con `undefined`; solo la primera llamada a `delete` la elimina.
Lecciones relacionadas
- JavaScript · Lección 3 · Avanzado · Versión: 4
- JavaScript · Lección 7 · Avanzado · Versión: 4
- JavaScript · Lección 41 · Intermedio · Versión: 3