Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Set.prototype.add — aggiungere un valore a un insieme

Set.prototype.add(value) aggiunge un singolo valore a un insieme, se non è già presente. Modifica il Set esistente e restituisce lo stesso oggetto, consentendo di concatenare le chiamate.

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.add(value)

set.add(value) aggiunge un valore a un oggetto Set esistente. Se il valore è già presente, l’insieme rimane invariato. Il metodo restituisce sempre lo stesso insieme, non un valore booleano che indica se l’inserimento è avvenuto; perciò si può scrivere set.add(a).add(b). Un nuovo valore viene collocato alla fine dell’ordine di iterazione; aggiungere di nuovo un valore già presente non ne cambia la posizione.

L’unicità segue il confronto SameValueZero: NaN è un duplicato di NaN, e -0 e +0 rappresentano lo stesso elemento; lo zero viene memorizzato come +0. Gli oggetti vengono confrontati per identità, non per contenuto. Due oggetti {} creati separatamente sono quindi elementi distinti, ma aggiungere di nuovo lo stesso riferimento non aumenta size.

add non espande gli array né gli altri iterabili: set.add([1, 2]) aggiunge un singolo array. Una chiamata senza argomenti aggiunge undefined. Il metodo richiede un ricevitore con dati interni di Set; Set.prototype.add.call({}, 1) genera un TypeError.

Esempi

const values = new Set();
const returned = values.add("blue").add("green").add("blue");
console.log(returned === values);
console.log(values.size);
console.log([...values].join(","));
values.add(NaN).add(NaN).add(-0).add(+0);
console.log(values.size);

Risultato

true
2
blue,green
4

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