CKTIS / JavaScript
Object.is: confronto SameValue
Object.is confronta due valori senza coercizione, considera NaN uguale a se stesso e distingue +0 da -0.
Versione: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintassi
Object.is(value1, value2)Object.is(value1, value2) restituisce un booleano secondo la relazione SameValue della specifica. Non converte i tipi: 1, 1n e "1" sono diversi. Per quasi tutti i valori coincide con ===, ma Object.is(NaN, NaN) è true e Object.is(+0, -0) è false.
Oggetti, funzioni e Symbols sono uguali solo se entrambi gli argomenti hanno la stessa identità; non confronta struttura o contenuto. È utile per rilevare un vero cambio di valore, gestire NaN e i casi in cui conta il segno dello zero, per esempio 1 / -0 produce -Infinity.
Il metodo esiste da ECMAScript 2015. SameValue non invoca metodi degli argomenti, trap Proxy o conversioni e non genera eccezioni. Un’eccezione può però avvenire prima, valutando un’espressione argomento. Map e Set usano SameValueZero, che non distingue i due zeri con segno.
Esempi
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));Risultato
true false false true true false false false
L’esempio confronta Object.is con === per NaN e zero con segno e mostra identità e assenza di coercizione.