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)restituiscetruese la voce esiste, altrimentifalse.get(key)restituisce il valore memorizzato, oppureundefinedse la voce non esiste. Usahas(key)per distinguere una voce assente da unundefinedmemorizzato.set(key, value)aggiunge una voce o sostituisce il valore associato alla stessa chiave. Accetta qualsiasi valore JavaScript e restituisce la stessa istanza diWeakMap, 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