Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Set.prototype.intersection — część wspólna zbiorów

Metoda intersection(other) zwraca nowy Set zawierający wartości wspólne dla obu zbiorów. Kolejność wyniku zależy od rozmiarów argumentów; other może być również obiektem udostępniającym interfejs podobny do Set.

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.intersection(other)

set.intersection(other) oblicza część wspólną: zwraca nowy Set zawierający wartości obecne w obu kolekcjach. Dla zwykłych zbiorów nie zmienia żadnego z wejść. Metoda jest częścią ECMAScript 2025, a nie API przeglądarki. Sama specyfikacja nie potwierdza obsługi w konkretnej przeglądarce; przed użyciem sprawdź typeof Set.prototype.intersection === "function". Obecność Node 24 w repozytorium nie dowodzi obsługi w przeglądarkach.

Odbiorca set musi być rzeczywistym obiektem Set. Argument other może być zbiorem lub obiektem podobnym do zbioru: musi udostępniać poprawne size oraz wywoływalne has i keys. Pasuje tu również Map, którego klucze są traktowane jako elementy. Sama iterowalność nie wystarcza: zwykła tablica nie spełnia tego interfejsu. Niepoprawny odbiorca powoduje TypeError.

Dla zwykłych zbiorów metoda przechodzi po mniejszym zbiorze i zachowuje jego kolejność wstawiania. Przy równych rozmiarach używa kolejności set. Dlatego a.intersection(b) i b.intersection(a) mogą mieć te same elementy w innej kolejności. W przypadku zwykłych zbiorów sprawdzanie przynależności odbywa się zgodnie z semantyką SameValueZero: NaN pasuje do NaN, +0 i -0 są równoważne, a obiekty muszą mieć tę samą tożsamość. Gdy rozmiar odbiorcy jest mniejszy lub równy rozmiarowi podanemu przez other, metoda sprawdza przynależność, wywołując other.has. Własna implementacja has nie musi stosować reguł SameValueZero i może na przykład uznawać różne obiekty za równoważne.

W przykładzie right jest mniejszy, więc wynik ma kolejność [3,2], a rozmiary wejść pozostają bez zmian. Własne gettery oraz metody has i keys obiektu other mogą wykonywać kod, zmieniać dane lub rzucać wyjątki; nie należy wtedy zakładać braku efektów ubocznych.

Przykłady

const left = new Set([1, 2, 3, 4]);
const right = new Set([3, 2]);
const common = left.intersection(right);

console.log(JSON.stringify([...common]));
console.log(left.size, right.size);

Wynik

[3,2]
4 2

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

Źródła