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.