Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje