CKTIS / JavaScript
WeakMap — metadati con chiavi mantenute debolmente
WeakMap associa valori a chiavi senza mantenere in vita le chiavi stesse. Scopri set, get, has e delete, il confronto delle chiavi basato sull’identità e i limiti relativi all’iterazione e alla garbage collection.
Versione: ECMAScript 2015 (ES2015) introduced WeakMap. ECMAScript 2023 (ES2023) added support for non-registered symbols as keys.
Sintassi
const wm = new WeakMap();
wm.set(key, value);
wm.get(key);
wm.has(key);
wm.delete(key);WeakMap memorizza associazioni chiave-valore. Le chiavi possono essere oggetti o simboli che non fanno parte del registro globale dei simboli, come Symbol(), ma non Symbol.for(). Il supporto per questi simboli fa parte di ECMAScript 2023; i motori meno recenti potrebbero accettare solo oggetti. I valori possono essere di qualsiasi tipo JavaScript. Gli oggetti vengono confrontati per identità: due oggetti {} distinti sono chiavi diverse.
WeakMap.set indica qui il metodo di istanza WeakMap.prototype.set, non un metodo statico. wm.set(key, value) aggiunge o sostituisce un valore e restituisce wm. Analogamente, WeakMap.get indica WeakMap.prototype.get: wm.get(key) restituisce il valore oppure undefined. WeakMap.prototype.has, chiamato come wm.has(key), distingue un elemento mancante da uno il cui valore è undefined.
WeakMap.delete indica WeakMap.prototype.delete: wm.delete(key) rimuove l’elemento e restituisce true se esisteva, oppure false altrimenti. Un tipo di chiave non valido provoca un TypeError con set; per quella chiave, get restituisce undefined, mentre has e delete restituiscono false.
L’associazione debole non impedisce la raccolta di una chiave che non è più raggiungibile in altro modo. Il momento della raccolta non è garantito; non basare su di esso la correttezza del programma. WeakMap non consente di iterare sugli elementi e non espone size. Usalo per i metadati associati agli oggetti; scegli Map se devi enumerare gli elementi.
Esempi
const metadata = new WeakMap();
const key = {};
const other = {};
console.log(metadata.set(key, 7) === metadata);
console.log(metadata.get(key));
console.log(metadata.has(other));
metadata.set(key, undefined);
console.log(metadata.has(key));
console.log(metadata.get(key) === undefined);
console.log(metadata.delete(key));
console.log(metadata.delete(key));Risultato
true 7 false true true true false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.
Fonti
- ECMAScript® Language Specification
- ECMAScript® Language Specification — Keyed Collections
- ECMAScript® 2023 Language Specification — Executable Code and Execution Contexts
- Official reference — tc39.es: ecma262
- Official reference — tc39.es: ecma262
- Official reference — tc39.es: ecma262
- Official reference — developer.mozilla.org: WeakMap / has