CKTIS / JavaScript
WeakSet: verificare e aggiungere elementi con has() e add()
Usa `has()` per verificare se un valore appartiene a un `WeakSet` e `add()` per aggiungerlo. L’appartenenza si basa sull’identità del valore e la raccolta non lo mantiene in vita.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
const seen = new WeakSet();
seen.has(value);
seen.add(value);WeakSet.prototype.has e WeakSet.prototype.add sono due metodi di istanza. seen.has(value) restituisce true se il valore è presente, false altrimenti. seen.add(value) inserisce il valore se non è già presente e restituisce la stessa istanza di WeakSet. Aggiungerlo di nuovo non crea duplicati; il valore restituito permette di concatenare le chiamate ad add().
L’appartenenza dipende dall’identità, non dal contenuto: due riferimenti allo stesso oggetto individuano lo stesso elemento, mentre due oggetti distinti con proprietà identiche non coincidono. ECMAScript 2024 accetta oggetti (incluse le funzioni) e simboli non registrati, come quelli creati con Symbol(). Per un simbolo ottenuto con Symbol.for(), un numero, una stringa o null, has() restituisce false e add() genera un TypeError. Entrambi i metodi generano un TypeError anche se this non è un’istanza di WeakSet, per esempio quando si invoca un metodo estratto senza associarlo all’istanza.
L’appartenenza da sola non impedisce al garbage collector di recuperare la memoria occupata dal valore. Non è possibile prevedere quando ciò avverrà. Un WeakSet non ha size e non è iterabile. Usalo per contrassegnare gli oggetti già elaborati quando non ti serve elencarli in seguito. Scegli Set se ti servono l’iterazione, la dimensione o elementi come numeri e stringhe.
Il supporto per i simboli può variare a seconda dell’ambiente di esecuzione. Se ti serve, prova add() con un valore creato tramite Symbol() nell’ambiente di destinazione: verificare che esista WeakSet non basta.
Esempi
{
const seen = new WeakSet();
const item = { id: 1 };
const alias = item;
console.log(seen.has(item));
console.log(seen.add(item).add(item) === seen);
console.log(seen.has(alias));
console.log(seen.has({ id: 1 }));
console.log(seen.has(1));
try {
seen.add(1);
} catch (error) {
console.log(error.name);
}
}Risultato
false true true false false TypeError
La prima chiamata a `has()` restituisce `false`. Le due chiamate ad `add()` si possono concatenare perché il metodo restituisce la stessa istanza. `alias` fa riferimento all’oggetto inserito; un nuovo oggetto con lo stesso `id` non coincide. Per il numero `1`, la verifica restituisce `false` e l’inserimento genera il `TypeError` che viene intercettato.
Lezioni correlate
- JavaScript · Lezione 17 · Avanzato · Versione: 4
- JavaScript · Lezione 43 · Avanzato · Versione: 4
- JavaScript · Lezione 45 · Avanzato · Versione: 4
- JavaScript · Lezione 40 · Intermedio · Versione: 3