Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Set.prototype.has — sprawdzanie obecności wartości

Metoda Set.prototype.has sprawdza, czy zbiór zawiera podaną wartość, i zwraca true albo false. Nie zmienia zbioru; porównuje wartości według reguły SameValueZero, a obiekty według ich tożsamości.

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

Set.prototype.has wywołuje się jako set.has(value), gdzie set jest zbiorem Set, a value szukaną wartością. Wynikiem jest true, jeśli wartość należy do zbioru, albo false, jeśli jej nie ma. Metoda nie dodaje ani nie usuwa elementów.

Porównanie odpowiada regule SameValueZero: nie zachodzi konwersja typów, więc 1 i "1" są różne. Wartość NaN pasuje do NaN, a +0 i -0 są traktowane jako równe. Obiekty są porównywane według tożsamości, nie zawartości: nowy obiekt z identycznymi właściwościami nie pasuje do zapisanego obiektu.

Pominięcie argumentu oznacza szukanie undefined, a nie sprawdzenie, czy zbiór jest pusty. Metoda wymaga odbiorcy z wewnętrznymi danymi zbioru Set; wywołanie jej ze zwykłym obiektem lub tablicą jako this powoduje TypeError.

W przykładzie item jest tą samą referencją, którą zapisano w zbiorze, natomiast { id: 1 } tworzy inny obiekt. Dlatego ostatnie dwa wyniki to odpowiednio true i false.

Przykłady

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

console.log(values.has(1));
console.log(values.has("1"));
console.log(values.has(NaN));
console.log(values.has(+0));
console.log(values.has(item));
console.log(values.has({ id: 1 }));

Wynik

true
false
true
true
true
false

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

Źródła