CKTIS / JavaScript
Object.is: comparação SameValue
Object.is compara dois valores sem conversão, considera NaN igual a si próprio e distingue +0 de -0.
Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxe
Object.is(value1, value2)Object.is(value1, value2) devolve um booleano segundo a relação SameValue da especificação. Não converte tipos: 1, 1n e "1" são diferentes. Para a maioria dos valores coincide com ===, mas Object.is(NaN, NaN) é true e Object.is(+0, -0) é false.
Objetos, funções e Symbols só são iguais se ambos os argumentos tiverem a mesma identidade; não compara estrutura nem conteúdo. É útil para detetar uma alteração real, tratar NaN e casos em que o sinal de zero importa, por exemplo porque 1 / -0 produz -Infinity.
O método existe desde ECMAScript 2015. SameValue não invoca métodos dos argumentos, traps Proxy ou conversões e não lança exceções. Uma exceção pode surgir antes, ao avaliar uma expressão argumento. Map e Set usam a relação diferente SameValueZero, que não distingue os zeros com sinal.
Exemplos
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));Resultado
true false false true true false false false
O exemplo contrasta Object.is com === para NaN e zero com sinal e mostra identidade e ausência de conversão.