CKTIS / JavaScript
Object.is: porovnání SameValue
Object.is porovná dvě hodnoty bez konverze, považuje NaN za rovné sobě a rozlišuje +0 od -0.
Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
Object.is(value1, value2)Object.is(value1, value2) vrací boolean podle vztahu SameValue ze specifikace. Typy nepřevádí: 1, 1n a "1" se liší. Pro většinu hodnot odpovídá ===, ale Object.is(NaN, NaN) je true a Object.is(+0, -0) je false.
Objekty, funkce a Symbols jsou shodné jen tehdy, když oba argumenty mají stejnou identitu; strukturu ani obsah metoda neporovnává. Hodí se pro zjištění skutečné změny, práci s NaN a případy, kdy záleží na znaménku nuly, například 1 / -0 dává -Infinity.
Metoda existuje od ECMAScript 2015. SameValue samo nevolá metody argumentů, pasti Proxy ani konverze a nevyhazuje. Výjimka může vzniknout dříve při vyhodnocení výrazu argumentu. Map a Set používají SameValueZero, které znaménka nuly nerozlišuje.
Příklady
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));Výsledek
true false false true true false false false
Příklad porovnává Object.is s === pro NaN a nulu se znaménkem a ukazuje identitu objektů i absenci konverze.