Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Set.prototype.delete — rimuovere un valore da un insieme

Set.prototype.delete(value) rimuove il valore indicato da un insieme esistente. Restituisce true se il valore è stato rimosso oppure false se era assente. Gli oggetti vengono confrontati in base all’identità, non al contenuto.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

set.delete(value)

set.delete(value) modifica un Set esistente: rimuove il valore corrispondente e restituisce true. Se il valore è assente, restituisce false senza modificare l’insieme. L’argomento indica un valore, non un indice. Il risultato è un booleano, non l’insieme, quindi non è possibile concatenare chiamate consecutive a .delete().

Il confronto segue la semantica SameValueZero: NaN corrisponde a NaN, e +0 e -0 sono considerati lo stesso valore. Gli oggetti vengono confrontati in base all’identità. Un nuovo oggetto { id: 1 } non corrisponde a un oggetto aggiunto in precedenza con gli stessi campi; bisogna passare un riferimento allo stesso oggetto.

Non confondere questo metodo con l’operatore delete, che rimuove proprietà dagli oggetti, né con set.clear(), che rimuove tutti gli elementi. Il metodo richiede un ricevitore con dati interni di Set; la chiamata Set.prototype.delete.call({}, value) genera un TypeError. Questa è un’API del linguaggio ECMAScript, non un’API del browser; la sola presenza di Node.js in un progetto non conferma il supporto nei browser di destinazione.

Esempi

const item = { id: 1 };
const values = new Set(["ready", item, NaN]);

console.log(values.delete("ready"));
console.log(values.delete("ready"));
console.log(values.delete({ id: 1 }));
console.log(values.delete(item));
console.log(values.delete(NaN));
console.log(values.size);

Risultato

true
false
false
true
true
0

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti