Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Object.is : comparaison SameValue

Object.is compare deux valeurs sans conversion, considère NaN égal à lui-même et distingue +0 de -0.

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

Syntaxe

Object.is(value1, value2)

Object.is(value1, value2) renvoie un booléen selon la relation SameValue de la spécification. Il n’effectue aucune conversion : 1, 1n et "1" diffèrent. Pour la plupart des valeurs il coïncide avec ===, mais Object.is(NaN, NaN) vaut true et Object.is(+0, -0) vaut false.

Objets, fonctions et Symbols ne sont égaux que si les deux arguments ont la même identité ; la structure et le contenu ne sont pas comparés. La méthode aide à détecter un vrai changement, à traiter NaN et les cas où le signe de zéro importe, par exemple 1 / -0 donnant -Infinity.

La méthode existe depuis ECMAScript 2015. SameValue n’appelle aucune méthode des arguments, aucun piège Proxy ni conversion et ne lève rien. Une exception peut toutefois naître plus tôt pendant l’évaluation d’un argument. Map et Set emploient SameValueZero, qui ne distingue pas les deux zéros signés.

Exemples

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

Résultat

true false
false true
true false
false false

L’exemple oppose Object.is à === pour NaN et zéro signé, puis montre identité d’objet et absence de conversion.

Sources