Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

WeakMap: verificare, leggere e scrivere voci con has(), get() e set()

Verifica se una chiave è presente, leggi il suo valore o aggiornalo. Impara a distinguere una voce assente da un `undefined` memorizzato e a riconoscere le chiavi valide.

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

Sintassi

weakMap.has(key)
weakMap.get(key)
weakMap.set(key, value)

WeakMap.prototype.has/get/set è un’abbreviazione per tre metodi di istanza di WeakMap. Le chiavi si confrontano per identità: due oggetti distinti con proprietà identiche sono chiavi diverse.

  • has(key) restituisce true se la voce esiste, altrimenti false.
  • get(key) restituisce il valore memorizzato, oppure undefined se la voce non esiste. Usa has(key) per distinguere una voce assente da un undefined memorizzato.
  • set(key, value) aggiunge una voce o sostituisce il valore associato alla stessa chiave. Accetta qualsiasi valore JavaScript e restituisce la stessa istanza di WeakMap, permettendo di concatenare le chiamate.

ECMAScript 2024 ammette come chiavi gli oggetti (incluse le funzioni) e i simboli non registrati, come Symbol() e Symbol.iterator, ma non i simboli ottenuti con Symbol.for(). Gli ambienti di esecuzione meno recenti potrebbero accettare solo chiavi di tipo oggetto; verifica il supporto per le chiavi di tipo simbolo nell’ambiente di destinazione.

Per una chiave non valida come 1, has() restituisce false, get() restituisce undefined e set() genera un TypeError. Tutti e tre i metodi controllano prima this: se non è una vera istanza di WeakMap, la chiamata genera un TypeError a prescindere dalla chiave.

Usa WeakMap per associare metadati a un oggetto senza mantenere in vita la chiave, anche quando il valore memorizzato fa riferimento a essa. Non è garantito quando verrà liberata la memoria. WeakMap non consente di iterare sulle chiavi e non espone size; usa Map se ti servono queste funzionalità o se vuoi usare stringhe o numeri come chiavi.

Esempi

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

  map.set(key, undefined);
  console.log(`stored: ${map.has(key)}, ${map.get(key)}`);
  console.log(`missing: ${map.has(lookalike)}, ${map.get(lookalike)}`);

  const result = map.set(key, 42);
  console.log(`updated: ${map.get(key)}, same map: ${result === map}`);

  console.log(`invalid key: ${map.has(1)}, ${map.get(1)}`);
  try {
    map.set(1, 42);
  } catch (error) {
    console.log(error.name);
  }
}

Risultato

stored: true, undefined
missing: false, undefined
updated: 42, same map: true
invalid key: false, undefined
TypeError

`key` e `lookalike` hanno lo stesso `id`, ma sono oggetti distinti. Entrambe le letture restituiscono inizialmente `undefined`; solo `has(key)` restituisce `true`. La seconda scrittura sostituisce il valore con `42` e restituisce la stessa mappa. La chiave `1` mostra la differenza tra lettura e scrittura con una chiave non valida.

Lezioni correlate

  • JavaScript · Lezione 17 · Avanzato · Versione: 4

Fonti