Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

WeakMap.prototype.set(): associare un valore a una chiave

`set()` aggiunge una voce a una `WeakMap` o sostituisce il valore associato a una chiave esistente. Restituisce la stessa istanza, quindi è possibile concatenare le chiamate.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

weakMap.set(key, value)

WeakMap.prototype.set è un metodo del prototipo che si chiama su un’istanza: weakMap.set(key, value). Aggiunge una voce per una nuova chiave oppure sostituisce il valore associato alla stessa chiave. Restituisce la stessa istanza, non il valore memorizzato, quindi puoi concatenare un’altra chiamata a .set(). Il valore può essere qualsiasi valore JavaScript, incluso undefined.

Le chiavi che sono oggetti si confrontano per identità: due oggetti distinti con proprietà identiche sono chiavi diverse. ECMAScript 2024 ammette anche i simboli non registrati, come Symbol("id"). I simboli ottenuti con Symbol.for("id") e altri valori primitivi, come le stringhe, non sono chiavi valide. Gli ambienti di esecuzione meno recenti potrebbero non supportare le chiavi di tipo simbolo; controlla l’ambiente di destinazione.

Una chiave non valida genera un TypeError. Anche chiamare il metodo separatamente dall’istanza senza il this corretto genera un TypeError: il ricevente deve essere un’istanza di WeakMap.

La voce non mantiene in vita la chiave da sola. Se la chiave non è più raggiungibile per altre vie, il garbage collector può rimuoverla; non fare affidamento sul momento in cui ciò accade. Le chiavi di una WeakMap non si possono enumerare. Se devi iterare sulle chiavi o usare stringhe come chiavi, usa invece una Map.

Esempi

{
  const metadata = new WeakMap();
  const item = { id: 1 };

  metadata.set(item, 10);
  console.log(metadata.get(item));

  const returned = metadata.set(item, 20);
  console.log(returned === metadata);
  console.log(metadata.get(item));
  console.log(metadata.has({ id: 1 }));

  try {
    metadata.set("id", 30);
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Risultato

10
true
20
false
true

La prima lettura restituisce `10`, mentre quella dopo l’aggiornamento restituisce `20`. Il confronto `returned === metadata` dà `true`. Un nuovo oggetto con lo stesso `id` non è la chiave memorizzata, quindi `has()` restituisce `false`. Il tentativo di usare una stringa come chiave genera un `TypeError`, che viene intercettato.

Lezioni correlate

  • JavaScript · Lezione 35 · Base · Versione: 4
  • JavaScript · Lezione 37 · Base · Versione: 4
  • JavaScript · Lezione 4 · Intermedio · Versione: 3
  • JavaScript · Lezione 10 · Intermedio · Versione: 3

Fonti