Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti