Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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) // boolean

WeakSet.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

Fonti