Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

WeakMap.prototype.get() — leggere un valore tramite la chiave

Usa `weakMap.get(key)` per leggere un valore senza modificare la mappa. Con `has()` puoi distinguere una voce mancante da una che contiene il valore `undefined`.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

weakMap.get(key)

WeakMap.prototype.get è un metodo di istanza che si chiama come weakMap.get(key). Restituisce il valore associato alla chiave senza aggiungere o modificare voci. Se il valore memorizzato è un oggetto, restituisce lo stesso oggetto, non una copia.

Le chiavi vengono confrontate per identità: due oggetti distinti con proprietà identiche sono chiavi diverse. ECMAScript 2024 consente di usare come chiavi oggetti e simboli non registrati, ad esempio quelli creati con Symbol(), ma non quelli ottenuti con Symbol.for(). Gli ambienti di esecuzione meno recenti potrebbero non supportare i simboli come chiavi.

get() restituisce undefined se la voce manca, se la chiave non è valida (ad esempio una stringa) o se il valore memorizzato è undefined. Usa weakMap.has(key) per distinguere un undefined memorizzato (true) da una voce mancante (false). A differenza di get(), set() genera un TypeError se la chiave non è valida. get() genera a sua volta un TypeError se this non è un’istanza di WeakMap, ad esempio se salvi il metodo in una variabile e lo chiami senza associarlo alla mappa.

Una WeakMap non mantiene in vita una chiave per il solo fatto di memorizzarla. Non puoi enumerarne le chiavi né prevedere quando il garbage collector recupererà la memoria di una chiave non raggiungibile.

Esempi

{
  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"));
}

Risultato

42
undefined
undefined
true
false
undefined

`lookalike` ha le stesse proprietà di `key`, ma è un altro oggetto. `get()` restituisce `undefined` sia per `lookalike` sia per `pending`, ma `has()` restituisce `true` solo per `pending`. La ricerca con la stringa `"id"` restituisce `undefined` senza generare eccezioni.

Lezioni correlate

  • JavaScript · Lezione 35 · Base · Versione: 4
  • JavaScript · Lezione 37 · Base · Versione: 4
  • JavaScript · Lezione 4 · Intermedio · Versione: 3
  • JavaScript · Lezione 10 · Intermedio · Versione: 3

Fonti