CKTIS / JavaScript
WeakMap.get() — leer un valor por clave
`weakMap.get(key)` devuelve el valor asociado a una clave. Usa `has(key)` para distinguir una entrada ausente de otra que almacena `undefined`.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
weakMap.get(key)WeakMap.get es una forma abreviada de referirse al método de instancia WeakMap.prototype.get, no a un método estático del constructor. weakMap.get(key) lee el valor almacenado sin modificar el mapa. Las claves se comparan por identidad: dos objetos creados por separado con las mismas propiedades son claves distintas. Si el valor almacenado es un objeto, get() devuelve ese mismo objeto, no una copia.
Tanto una entrada ausente como una entrada que almacena undefined dan como resultado undefined. Usa weakMap.has(key) para distinguirlas: devuelve true si la entrada existe, aunque su valor sea undefined.
ECMAScript 2024 admite como claves objetos, incluidas las funciones, y símbolos no registrados como Symbol('id'). Algunos motores antiguos admiten WeakMap, pero no claves de tipo símbolo. En una instancia de WeakMap, get() devuelve undefined si la clave no es válida, por ejemplo, si es una cadena o un símbolo devuelto por Symbol.for(); en cambio, set() lanza un TypeError. get() también lanza un TypeError si su this no es una instancia de WeakMap, por ejemplo, si llamas al método por separado sin vincularlo a una instancia.
El mapa por sí solo no mantiene viva una clave. Cuando la clave deja de ser alcanzable, su entrada puede eliminarse durante la recolección de basura. No puedes enumerar las claves ni contar con que una entrada se elimine en un momento concreto.
Ejemplos
const weakMap = new WeakMap();
const key = { id: 1 };
const otherKey = { id: 1 };
weakMap.set(key, 42);
console.log(String(weakMap.get(key)));
console.log(String(weakMap.get(otherKey)));
weakMap.set(otherKey, undefined);
console.log(String(weakMap.get(otherKey)));
console.log(String(weakMap.has(otherKey)));
console.log(String(weakMap.get('id')));Resultado
42 undefined undefined true undefined
`key` y `otherKey` son objetos distintos aunque tengan las mismas propiedades. Las dos consultas de `otherKey` devuelven `undefined`: primero no hay entrada y después existe con el valor `undefined`, como confirma `has()`. La última consulta usa una clave no válida.
Lecciones relacionadas
- JavaScript · Lección 18 · Básico · Versión: 4