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.