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

CKTIS / JavaScript

WeakMap.prototype.get() — leer un valor por su clave

Usa `weakMap.get(key)` para leer un valor sin modificar el mapa. Con `has()` puedes distinguir una entrada ausente de otra cuyo valor almacenado es `undefined`.

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

Sintaxis

weakMap.get(key)

WeakMap.prototype.get es un método de instancia que se invoca como weakMap.get(key). Devuelve el valor asociado a la clave sin añadir ni modificar ninguna entrada. Si el valor almacenado es un objeto, devuelve ese mismo objeto, no una copia.

Las claves se comparan por identidad: dos objetos distintos con propiedades idénticas son claves diferentes. ECMAScript 2024 admite objetos y símbolos no registrados como claves, por ejemplo los creados con Symbol(), pero no los obtenidos con Symbol.for(). Es posible que los entornos de ejecución antiguos no admitan símbolos como claves.

get() devuelve undefined si no existe la entrada, si la clave no es válida (por ejemplo, una cadena) o si el valor almacenado es undefined. Usa weakMap.has(key) para distinguir un undefined almacenado (true) de una entrada ausente (false). A diferencia de get(), set() lanza un TypeError si la clave no es válida. El propio get() lanza un TypeError si su this no es una instancia de WeakMap, por ejemplo si guardas el método en una variable y lo llamas sin vincularlo al mapa.

Un WeakMap no mantiene viva una clave por el mero hecho de almacenarla. Sus claves no se pueden enumerar, ni se puede predecir cuándo el recolector de basura recuperará la memoria de una clave inalcanzable.

Ejemplos

{
  const weakMap = new WeakMap();
  const key = { id: 1 };
  const lookalike = { id: 1 };
  const pending = {};

  weakMap.set(key, 42);
  weakMap.set(pending, undefined);

  console.log(weakMap.get(key));
  console.log(weakMap.get(lookalike));
  console.log(weakMap.get(pending));
  console.log(weakMap.has(pending));
  console.log(weakMap.has(lookalike));
  console.log(weakMap.get("id"));
}

Resultado

42
undefined
undefined
true
false
undefined

`lookalike` tiene las mismas propiedades que `key`, pero es otro objeto. `get()` devuelve `undefined` tanto para `lookalike` como para `pending`, pero `has()` solo devuelve `true` para `pending`. La consulta con la cadena `"id"` devuelve `undefined` sin lanzar una excepción.

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