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