Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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