Object.is()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2015.

La méthode Object.is() permet de déterminer si deux valeurs sont les mêmes.

Dans cet article

Syntaxe

Object.is(value1, value2);

Paramètres

valeur1

La première valeur à comparer.

valeur2

La seconde valeur à comparer.

Valeur de retour

Un booléen indiquant si les arguments ont la même valeur.

Description

Object.is() permet de déterminer si deux valeurs sont identiques. Deux valeurs sont considérées identiques si :

elles sont toutes les deux undefined
elles sont toutes les deux null
elles sont toutes les deux true ou toutes les deux false
elles sont des chaînes de caractères de la même longueur et avec les mêmes caractères (dans le même ordre)
elles sont toutes les deux le même objet
elles sont des nombres et
- sont toutes les deux égales à +0
- sont toutes les deux égales à -0
- sont toutes les deux égales à NaN
- sont non-nulles, ne sont pas NaN et ont toutes les deux la même valeur

Attention, ce n'est pas la même égalité qu'avec l'opérateur ==. L'opérateur == applique différentes conversions à chaque opérande (si ils ne sont pas du même type) avant de tester l'égalité (d'où le comportement "" == false qui donne true), Object.is ne convertit aucune des deux valeurs.

Cette égalité est également différente de l'égalité stricte qu'on peut avoir avec l'opérateur ===. L'opérateur === (et également l'opérateur ==) considère que -0 et +0 sont égales et que Number.NaN n'est pas égal à NaN.

Exemples

js
Object.is("toto", "toto"); // true
Object.is(window, window); // true

Object.is("toto", "truc"); // false
Object.is([], []); // false

var toto = { a: 1 };
var truc = { a: 1 };
Object.is(toto, toto); // true
Object.is(toto, truc); // false

Object.is(null, null); // true

// Cas aux limites (cas spéciaux)
Object.is(0, -0); // false
Object.is(-0, -0); // true
Object.is(NaN, 0 / 0); // true

Prothèse d'émulation (polyfill)

js
if (!Object.is) {
  Object.is = function (v1, v2) {
    // Algorithme SameValue
    if (v1 === v2) {
      //Étapes 1-5, 7-10
      //Étapes 6.b-6.b +0 !=-0
      return v1 !== 0 || 1 / v1 === 1 / v2;
    } else {
      //Étapes 6.a: NaN == NaN
      return v1 !== v1 && v2 !== v2;
    }
  };
}

Guide JavaScript : L'égalité en JavaScript qui illustre les trois manières de comparer en JavaScript
Les opérateurs de comparaison

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 2 déc. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu