Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

WeakMap.set(): aggiungere o sostituire un valore

Il metodo `set()` associa un valore a una chiave in una `WeakMap`. Se la chiave esiste già, ne sostituisce il valore. Restituisce la stessa mappa, così puoi concatenare le chiamate.

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

Sintassi

weakMap.set(key, value)

WeakMap.set indica il metodo di istanza WeakMap.prototype.set, non un metodo statico del costruttore WeakMap. weakMap.set(key, value) aggiunge una voce se la chiave è nuova o sostituisce il valore se la chiave esiste già. Restituisce la stessa WeakMap, quindi puoi concatenare un’altra chiamata a .set(). Puoi memorizzare qualsiasi valore; se ometti value, viene memorizzato undefined.

Le chiavi di tipo oggetto si confrontano per identità: due oggetti {} creati separatamente sono chiavi diverse. ECMAScript 2024 ammette anche simboli non registrati come Symbol(). Gli ambienti di esecuzione meno recenti potrebbero accettare solo oggetti come chiavi. Usare come chiave una stringa, un numero, null o un simbolo registrato tramite Symbol.for() genera un TypeError. Lo stesso accade se chiami il metodo con un this che non è un’istanza di WeakMap.

Una voce non mantiene in vita la propria chiave da sola. Se la chiave non è più raggiungibile al di fuori di questa associazione debole, il garbage collector può eliminarla, ma non è garantito quando. Questo permette di memorizzare dati aggiuntivi su un oggetto senza prolungarne la vita. Usa Map se ti servono chiavi di tipo stringa o se devi iterare sulle voci.

Esempi

{
  const statuses = new WeakMap();
  const task = {};
  const otherTask = {};

  const result = statuses.set(task, "pending").set(otherTask, false);
  statuses.set(task, "ready");

  console.log(result === statuses);
  console.log(statuses.get(task));
  console.log(statuses.get(otherTask));
  console.log(statuses.has({}));

  try {
    statuses.set("task", "ready");
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Risultato

true
ready
false
false
true

Il primo `true` mostra che le chiamate concatenate restituiscono la stessa mappa. `ready` sostituisce `pending`. Il primo `false` è il valore memorizzato per `otherTask`; il secondo indica che il nuovo `{}` non è una chiave della mappa. L’ultimo `true` conferma che la chiave di tipo stringa ha generato un `TypeError`.

Lezioni correlate

  • JavaScript · Lezione 18 · Base · Versione: 4

Fonti