Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

WeakMap.prototype.delete() — rimuovere una voce

Chiama `weakMap.delete(key)` per rimuovere la voce associata a una chiave. Il metodo restituisce `true` se ha rimosso una voce, altrimenti `false`.

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

Sintassi

weakMap.delete(key)

WeakMap.delete è un nome abbreviato per il metodo di istanza WeakMap.prototype.delete. Chiamalo come weakMap.delete(key), non come metodo statico del costruttore WeakMap. Rimuove l’associazione tra chiave e valore solo da quella mappa. A differenza dell’operatore delete, non elimina proprietà di un oggetto.

true indica che una voce era presente ed è stata rimossa, anche se il suo valore era undefined. Se la voce manca, il risultato è false. Le chiavi oggetto si confrontano per identità: due oggetti distinti con le stesse proprietà non corrispondono. Dopo la rimozione, weakMap.has(key) restituisce false, a meno che tu non aggiunga di nuovo una voce per quella chiave.

ECMAScript 2024 ammette come chiavi gli oggetti e i simboli non registrati come Symbol(), ma non quelli ottenuti con Symbol.for(). Il supporto per le chiavi simboliche dipende dall’ambiente di esecuzione. Su un’istanza valida, delete() restituisce false con una chiave non valida, come una stringa, o se ometti l’argomento; set() genera un TypeError con una chiave non valida. Anche chiamare delete() senza un’istanza valida come this genera un TypeError.

Una WeakMap non mantiene in vita un oggetto solo perché è usato come chiave. La rimozione esplicita elimina subito la voce, anche se il codice conserva un riferimento alla chiave. Non distrugge l’oggetto né forza la garbage collection.

Esempi

{
  const notes = new WeakMap();
  const key = { id: 1 };
  notes.set(key, undefined);

  console.log(notes.delete({ id: 1 }));
  console.log(notes.delete(key));
  console.log(notes.has(key));
  console.log(notes.delete(key));
  console.log(notes.delete("id"));
}

Risultato

false
true
false
false
false

L’oggetto distinto `{ id: 1 }` non corrisponde a `key`. La rimozione con `key` restituisce `true` anche se il valore memorizzato è `undefined`. Poi `has()`, una seconda rimozione e un tentativo con una stringa come chiave restituiscono tutti `false`.

Lezioni correlate

  • JavaScript · Lezione 18 · Base · Versione: 4

Fonti