WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.is: Vergleich mit SameValue

Object.is vergleicht zwei Werte ohne Konvertierung, setzt NaN sich selbst gleich und unterscheidet +0 von -0.

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

Syntax

Object.is(value1, value2)

Object.is(value1, value2) liefert einen Boolean nach der Spezifikationsrelation SameValue. Es konvertiert keine Typen: 1, 1n und "1" sind verschieden. Für die meisten Werte entspricht es ===, doch Object.is(NaN, NaN) ist true und Object.is(+0, -0) ist false.

Objekte, Funktionen und Symbole sind nur gleich, wenn beide Argumente denselben Identitätswert besitzen; Struktur oder Inhalt werden nicht verglichen. Das hilft beim Erkennen echter Wertänderungen, bei NaN und wenn das Vorzeichen von Null zählt, etwa weil 1 / -0 den Wert -Infinity ergibt.

Die Methode existiert seit ECMAScript 2015. SameValue selbst ruft keine Argumentmethoden, Proxy-Fallen oder Konvertierungen auf und wirft nicht. Eine Ausnahme kann zuvor beim Auswerten eines Argumentausdrucks entstehen. Map und Set nutzen SameValueZero, das die beiden Nullvorzeichen nicht unterscheidet.

Beispiele

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));

Ergebnis

true false
false true
true false
false false

Das Beispiel vergleicht Object.is mit === für NaN und Nullvorzeichen und zeigt Objektidentität sowie fehlende Konvertierung.

Quellen