CKTIS / JavaScript
WeakMap.prototype.delete(): rimuovere una voce tramite la chiave
Rimuovi una voce da una `WeakMap` e usa il risultato booleano per sapere se la voce è stata effettivamente rimossa.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
weakMap.delete(key)WeakMap.prototype.delete è un metodo di istanza. La chiamata weakMap.delete(key) rimuove da quella mappa la voce associata a key. Restituisce true solo se ha rimosso una voce esistente, anche se il valore memorizzato era undefined. Se la voce non esiste, restituisce false.
Le chiavi vengono confrontate per identità: due oggetti distinti con le stesse proprietà sono chiavi diverse. ECMAScript 2024 ammette oggetti e simboli non registrati, come quelli creati con Symbol(). Il supporto per i simboli come chiavi varia a seconda dell’ambiente di esecuzione. Se la chiave non è valida, ad esempio se è una stringa o un simbolo ottenuto con Symbol.for(), delete() restituisce false, mentre set() genera un TypeError. Anche una chiamata con un this non valido, come WeakMap.prototype.delete.call({}, key), genera un TypeError.
Il metodo rimuove subito l’associazione. Non modifica l’oggetto usato come chiave, non ne elimina le proprietà come farebbe l’operatore delete e non forza il garbage collector a intervenire. Usalo quando l’associazione memorizzata non serve più ma la chiave è ancora disponibile.
Esempi
{
const weakMap = new WeakMap();
const key = { id: 1 };
weakMap.set(key, undefined);
console.log(weakMap.delete({ id: 1 }));
console.log(weakMap.delete(key));
console.log(weakMap.has(key));
console.log(weakMap.delete(key));
console.log(weakMap.delete("id"));
}Risultato
false true false false false
Il nuovo oggetto `{ id: 1 }` non corrisponde alla chiave memorizzata. La chiave originale `key` permette di rimuovere la voce anche se il valore è `undefined`. Il controllo con `has()`, la seconda rimozione e il tentativo con una chiave di tipo stringa restituiscono tutti `false`.
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
- ECMAScript 2024 Language Specification — WeakMap.prototype.delete (key)
- ECMAScript Language Specification — WeakMap.prototype.delete (key)
- ECMAScript 2024 Language Specification — CanBeHeldWeakly (v)
- ECMAScript 2024 Language Specification — WeakMap Objects
- ECMAScript 2024 Language Specification — The delete Operator
- MDN — WeakMap.prototype.delete()
- MDN — WeakMap browser compatibility