CKTIS / JavaScript
WeakSet: verificare, aggiungere e rimuovere elementi
Usa `has()` per verificare se un valore è presente, `add()` per aggiungerlo e `delete()` per rimuoverlo. I tre metodi differiscono per il valore restituito e per come gestiscono gli argomenti non ammessi.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
weakSet.has(value) // boolean
weakSet.add(value) // the same WeakSet instance
weakSet.delete(value) // booleanWeakSet.prototype.has/add/delete è un modo abbreviato per indicare tre metodi di WeakSet.prototype, non il nome di un singolo metodo. Chiamali su un’istanza, come in seen.has(value). Una chiamata senza un’istanza di WeakSet come this genera un TypeError, anche se separi il metodo dall’istanza e lo chiami come una normale funzione.
has(value) restituisce true se il valore è presente e false altrimenti, senza modificare l’insieme. add(value) inserisce il valore solo se è assente e, se la chiamata riesce, restituisce la stessa istanza, così puoi concatenare le chiamate. delete(value) restituisce true solo se ha rimosso un elemento; altrimenti restituisce false. L’appartenenza dipende dall’identità, non dal contenuto: due oggetti { id: 1 } creati separatamente sono elementi distinti.
ECMAScript 2024 ammette gli oggetti (incluse le funzioni) e i simboli non registrati, come Symbol(). I simboli del registro globale restituiti da Symbol.for() e gli altri valori primitivi, come 1 e null, non sono ammessi. Per un valore non ammesso, add() genera un TypeError, mentre has() e delete() restituiscono false. Gli ambienti di esecuzione meno recenti potrebbero accettare solo oggetti; verifica il supporto per i simboli nell’ambiente di destinazione.
Una voce in un WeakSet non basta a mantenere in vita un valore. Se il valore non è più raggiungibile tramite riferimenti forti, il garbage collector può liberarne la memoria; non fare affidamento su quando accadrà. Un WeakSet non è iterabile e non ha una proprietà size. Usalo per contrassegnare oggetti già elaborati; se devi scorrere o contare gli elementi, usa Set, che mantiene riferimenti forti ai propri elementi.
Esempi
{
const seen = new WeakSet();
const task = { id: 1 };
const lookalike = { id: 1 };
console.log(seen.add(task).add(task) === seen);
console.log(seen.has(task));
console.log(seen.has(lookalike));
console.log(seen.delete(task));
console.log(seen.delete(task));
console.log(seen.has(task));
console.log(seen.has(1));
console.log(seen.delete(1));
try {
seen.add(1);
} catch (error) {
console.log(error instanceof TypeError);
}
}Risultato
true true false true false false false false true
Anche aggiungendo `task` due volte, il risultato è `seen`. `lookalike` ha lo stesso contenuto, ma non appartiene all’insieme. Solo la prima rimozione di `task` restituisce `true`. L’ultimo `true` conferma il tipo di errore di `add(1)`; l’output non dipende dal garbage collector.
Lezioni correlate
- JavaScript · Lezione 30 · Intermedio · Versione: 3