Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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