Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti