CKTIS / JavaScript
WeakSet — un insieme con riferimenti deboli
WeakSet contiene oggetti unici e simboli non registrati senza mantenerli in vita soltanto per la loro appartenenza all’insieme. Offre add, has e delete, ma non consente di iterare sugli elementi né di leggerne il numero.
Versione: WeakSet was introduced in ECMAScript 2015 (ES2015). Support for non-registered symbols as elements was added in ECMAScript 2023 (ES2023).
Sintassi
new WeakSet()
new WeakSet(iterable)
weakSet.add(value)
weakSet.has(value)
weakSet.delete(value)WeakSet serve a tenere traccia di valori, per esempio di oggetti già elaborati. Gli oggetti si distinguono in base all’identità, non al contenuto: due oggetti distinti { id: 1 } sono elementi diversi. new WeakSet(iterable) aggiunge i valori dell’iterabile fornito; il costruttore richiede new.
WeakSet.prototype.add(value) aggiunge un elemento, ignora i duplicati e restituisce lo stesso insieme, consentendo di concatenare le chiamate. WeakSet.prototype.has(value) restituisce l’appartenenza come boolean. WeakSet.prototype.delete(value) restituisce true se ha rimosso un elemento esistente, altrimenti false.
Sono ammessi gli oggetti, comprese le funzioni, e i simboli non registrati tramite Symbol.for. Per valori non supportati, come numeri, stringhe, null o un risultato di Symbol.for, add genera un TypeError, mentre has e delete restituiscono false. Il supporto ai simboli è stato aggiunto in ECMAScript 2023; i motori più datati potrebbero accettare solo oggetti. La specifica del linguaggio non è una tabella di compatibilità dei browser: verifica il supporto di questa funzionalità nell’ambiente di destinazione.
A differenza di Set, WeakSet non mantiene in vita gli elementi soltanto per la loro appartenenza. Non è garantito quando avverrà la garbage collection. Non sono disponibili size, iterazione, forEach o clear; per verificare l’appartenenza devi avere il valore da controllare. Scegli Set se devi enumerare gli elementi o conoscerne il numero.
Esempi
const first = { id: 1 };
const second = { id: 1 };
const seen = new WeakSet([first]);
console.log(seen.has(first));
console.log(seen.has(second));
console.log(seen.add(second) === seen);
console.log(seen.has(second));
console.log(seen.delete(first));
console.log(seen.delete(first));
console.log(seen.has(first));Risultato
true false true true true false 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 — Keyed Collections
- ECMAScript® 2026 Language Specification — Executable Code and Execution Contexts
- Official reference — developer.mozilla.org: WeakSet / has
- Official reference — developer.mozilla.org: WeakSet / add
- Official reference — tc39.es: ecma262