--- title: Object.is() slug: Web/JavaScript/Reference/Global_Objects/Object/is tags: - Comparación - Condición - ECMAScript2015 - JavaScript - Objeto - condicional - igualdad - metodo translation_of: Web/JavaScript/Reference/Global_Objects/Object/is original_slug: Web/JavaScript/Referencia/Objetos_globales/Object/is ---
{{JSRef}}

El método Object.is() determina si dos valores son iguales.

Síntaxis

Object.is(valor1, valor2);

Parámetros

valor1
Primer valor a comparar.
valor2
Segundo valor a comparar.

Valor return del método

Este método devuelve un valor de tipo {{jsxref("Boolean")}} indicando si los valores pasados como parámetros son iguales o no.

Descripción

Object.is() determina si dos valores son iguales. Dos valores son iguales si se puede asegurar que:

Esta comparación no es igual a la que realiza el operador {{jsxref("Operators/Comparison_Operators", "==", "#Equality")}}. El operador {{jsxref("Operators/Comparison_Operators", "==", "#Equality")}} aplica varias coerciones(comprobaciones) en ambos sentidos (si no tienen el mismo Type) antes de probar la igualdad (lo que resulta en comportamientos como  "" == false siendo true), pero Object.is no obliga a niguno de los valores.

Esta tampoco es igual a la que realiza el operador {{jsxref("Operators/Comparison_Operators", "===", "#Identity")}}. El operador {{jsxref("Operators/Comparison_Operators", "===", "#Identity")}} (y el operador {{jsxref("Operators/Comparison_Operators", "==", "#Equality")}}) trata los valores -0 y +0 como iguales, y además, trata {{jsxref("Number.NaN")}} como no igual a {{jsxref("NaN")}}.

Ejemplos

Object.is('foo', 'foo');     // true
Object.is(window, window);   // true

Object.is('foo', 'bar');     // false
Object.is([], []);           // false

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

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

// Special Cases
Object.is(0, -0);            // false
Object.is(-0, -0);           // true
Object.is(NaN, 0/0);         // true

Polyfill para navegadores no ES6

Object.is() es una adición propuesta en el estandar ECMA-262; y como tal, puede no estar presente en todos los navegadores. Para los casos en que no tenga disponible este método, podría utilizar este código haciendolo que se cargue antes que cualquier otro script. Esto permite que puedas utilizar Object.is() en los navegadores que no lo llevan incluído.

if (!Object.is) {
  Object.is = function(x, y) {
    // SameValue algorithm
    if (x === y) { // Steps 1-5, 7-10
      // Steps 6.b-6.e: +0 != -0
      return x !== 0 || 1 / x === 1 / y;
    } else {
      // Step 6.a: NaN == NaN
      return x !== x && y !== y;
    }
  };
}

Especificaciones

Especificación Estado Comentario
{{SpecName('ES6', '#sec-object.is', 'Object.is')}} {{Spec2('ES6')}} Definición inicial.

Compatibilidad en navegadores

{{CompatibilityTable}}
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support {{CompatChrome("30")}} {{CompatGeckoDesktop("22")}} {{CompatNo}} {{CompatVersionUnknown}} {{CompatNo}}
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support {{CompatNo}} {{CompatUnknown}} {{CompatGeckoMobile("22")}} {{CompatNo}} {{CompatNo}} {{CompatNo}}

Ver también