Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Set — kolekcja unikalnych wartości

Set przechowuje każdą odrębną wartość tylko raz i pozwala iterować w kolejności dodawania. Służy do usuwania duplikatów oraz sprawdzania obecności wartości bez ręcznego przeszukiwania tablicy.

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

new Set()
new Set(iterable)
set.add(value)
set.has(value)
set.delete(value)
set.clear()
set.size

Set jest wbudowaną kolekcją wartości, a nie par klucz–wartość. Twórz ją przez new Set() albo new Set(iterable), np. z tablicy. Konstruktor wymaga new. Powtórzenia nie tworzą dodatkowych elementów.

add(value) dodaje wartość i zwraca ten sam zbiór, więc można łączyć wywołania. has(value) zwraca informację o obecności, a delete(value) zwraca true, jeśli usunięto element, albo false, jeśli go nie było. clear() usuwa wszystkie elementy. Liczbę elementów odczytuje się przez właściwość size, nie przez length ani size().

Unikalność określa reguła SameValueZero: NaN jest równoważne NaN, a +0 i -0 oznaczają ten sam element. 1 i "1" pozostają różne. Obiekty są porównywane według tożsamości, nie zawartości: dwa oddzielnie utworzone {} to dwa elementy.

Iteracja przez for...of lub [...set] zachowuje kolejność dodawania. Ponowne dodanie istniejącej wartości nie zmienia jej pozycji; usunięcie i ponowne dodanie przenosi ją na koniec. Set nie udostępnia dostępu do elementów przez indeks liczbowy.

Opis dotyczy podstawowego API, bez nowszych metod operacji na zbiorach. Specyfikacja języka nie jest tabelą zgodności przeglądarek: dostępność trzeba sprawdzić w środowisku docelowym; Node 24 nie dowodzi obsługi w przeglądarce.

Przykłady

const values = new Set([3, 1, 3, 2]);
values.add(1);
console.log(values.size);
console.log(values.has(2));
console.log(values.delete(1));
values.add(1);
console.log([...values].join(','));

Wynik

3
true
true
3,2,1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła