Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Object.is: porównanie SameValue

Object.is porównuje dwie wartości bez konwersji, uznając NaN za równy sobie i rozróżniając +0 od -0.

Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2

Składnia

Object.is(value1, value2)

Object.is(value1, value2) zwraca boolean według relacji specyfikacji SameValue. Nie wykonuje konwersji typów: 1, 1n i "1" są różne. Dla większości wartości wynik odpowiada ===, lecz Object.is(NaN, NaN) jest true, a Object.is(+0, -0) jest false.

Obiekty, funkcje i symbole są równe tylko wtedy, gdy oba argumenty są tą samą wartością tożsamościową; metoda nie porównuje struktury ani zawartości. Jest przydatna przy wykrywaniu rzeczywistej zmiany wartości, obsłudze NaN i sytuacjach, w których znak zera ma znaczenie, np. 1 / -0 daje -Infinity.

Metoda istnieje od ECMAScript 2015. Sama operacja SameValue nie wywołuje metod argumentów, pułapek Proxy ani konwersji i nie rzuca wyjątków. Wyjątek może jednak powstać wcześniej podczas obliczania wyrażeń przekazanych jako argumenty. Kolekcje Map i Set używają innej relacji SameValueZero, która nie rozróżnia znaków zera.

Przykłady

const item = {};
const other = {};

console.log(Object.is(NaN, NaN), NaN === NaN);
console.log(Object.is(0, -0), 0 === -0);
console.log(Object.is(item, item), Object.is(item, other));
console.log(Object.is(1, 1n), Object.is("1", 1));

Wynik

true false
false true
true false
false false

Przykład zestawia Object.is z === dla NaN i zer ze znakiem oraz pokazuje tożsamość obiektów i brak konwersji.

Źródła