CKTIS / JavaScript
WeakMap: leggere, scrivere ed eliminare voci
Scopri cosa restituiscono `get`, `set` e `delete`, quali chiavi accetta una `WeakMap` e come distinguere una voce assente da una che contiene `undefined`.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
const wm = new WeakMap();
wm.get(key);
wm.set(key, value);
wm.delete(key);get, set e delete sono tre metodi di WeakMap.prototype. Si chiamano su un’istanza di WeakMap, ad esempio wm.get(key), non come metodi statici del costruttore. Una chiamata senza un’istanza appropriata o con un valore di this incompatibile genera un TypeError.
wm.get(key) restituisce il valore memorizzato, oppure undefined se la chiave è assente o non valida. Usa wm.has(key) per distinguere una voce assente da un valore undefined memorizzato. wm.set(key, value) aggiunge una voce o ne sostituisce il valore. Accetta qualsiasi valore e restituisce la stessa istanza, così puoi concatenare le chiamate. wm.delete(key) restituisce true se rimuove una voce e false se la chiave è assente o non valida. Il metodo rimuove una voce, non una proprietà di un oggetto come fa l’operatore delete.
ECMAScript 2024 ammette come chiavi gli oggetti, comprese le funzioni, e i simboli non registrati, come quelli creati con Symbol(). I simboli registrati con Symbol.for() e gli altri valori primitivi non sono chiavi valide; set genera un TypeError in questi casi. Le chiavi si confrontano per identità: due oggetti distinti con le stesse proprietà sono chiavi diverse. Verifica che l’ambiente di esecuzione di destinazione supporti le chiavi di tipo simbolo.
Una WeakMap permette di associare metadati a un oggetto senza mantenerlo in vita solo perché è usato come chiave. La collezione non conserva riferimenti forti alle chiavi. Non è garantito quando verrà recuperata la memoria e le chiavi non sono enumerabili. Usa una Map se devi iterare sulle chiavi.
Esempi
{
const metadata = new WeakMap();
const item = { id: 1 };
console.log(metadata.set(item, 1) === metadata);
metadata.set(item, 2);
console.log(metadata.get(item));
console.log(metadata.get({ id: 1 }));
metadata.set(item, undefined);
console.log(metadata.get(item) === undefined && metadata.has(item));
console.log(metadata.delete(item));
console.log(metadata.delete(item));
console.log(metadata.get(item));
}Risultato
true 2 undefined true true false undefined
`set` restituisce la stessa collezione e sostituisce `1` con `2`. Il nuovo oggetto `{ id: 1 }` è una chiave diversa. `has` conferma che la voce con `undefined` esiste; solo la prima chiamata a `delete` la rimuove.
Lezioni correlate
- JavaScript · Lezione 3 · Avanzato · Versione: 4
- JavaScript · Lezione 7 · Avanzato · Versione: 4
- JavaScript · Lezione 41 · Intermedio · Versione: 3