CKTIS / JavaScript
Set.prototype.add — dodawanie wartości do zbioru
Set.prototype.add(value) dodaje pojedynczą wartość do zbioru, jeśli jeszcze jej nie zawiera. Modyfikuje istniejący Set i zwraca ten sam obiekt, co umożliwia łączenie wywołań.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
set.add(value)set.add(value) dodaje jedną wartość do istniejącego obiektu Set. Jeśli wartość już występuje, zbiór pozostaje bez zmian. Metoda zawsze zwraca ten sam zbiór, a nie informację logiczną o dodaniu, dlatego można pisać set.add(a).add(b). Nowa wartość trafia na koniec kolejności iteracji; ponowne dodanie obecnej wartości nie zmienia jej pozycji.
Unikalność odpowiada porównaniu SameValueZero: NaN jest duplikatem NaN, a -0 i +0 oznaczają ten sam element; zero jest przechowywane jako +0. Obiekty są porównywane według tożsamości, nie zawartości. Dwa osobno utworzone obiekty {} są więc różnymi elementami, ale ponowne dodanie tej samej referencji nie zwiększa size.
add nie rozwija tablic ani innych obiektów iterowalnych: set.add([1, 2]) dodaje jedną tablicę. Wywołanie bez argumentu dodaje undefined. Metoda wymaga odbiorcy z wewnętrznymi danymi Set; Set.prototype.add.call({}, 1) zgłasza TypeError.
Przykłady
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);Wynik
true 2 blue,green 4
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.