Object.is()

Il metodo Object.is() determina se i due parametri di input hanno lo stesso valore.

Sintassi

Object.is(value1, value2);

Parametri

value1

Il primo valore da comparare.

value2

Il secondo valore da comparare.

Return value

A Boolean indicating whether or not the two arguments are the same value.

Descrizione

Object.is() determina se due valori sono uguali. Due valori sono uguali se sono :

• entrambi undefined
• entrambi null
• entrambi  true o entrambi false
• entrambi stringhe della stessa lunghezza con gli stessi caratteri
• entrambi lo stesso oggetto
• entrambi numeri ed
  • entrambi  +0
  • entrambi  -0
  • entrambi NaN
  • o entrambi non sono 0 ed entrambi non sono NaN ed entrambi hanno lo stesso valore

Questo non è la stessa uguaglianza dell'operatore ==. L'operatore == applica varie conversioni ad entrambi (se non sono dello stesso tipo) prima di testare l'uguaglianza (ad esempio, "" == false risultando true), ma Object.is non converte i loro valori.

Inoltre questo non è la stessa uguaglianza dell'operatore ===. L'operatore === (ed anche l'operatore ==) trattano i numeri -0 e +0 come uguali e trattano Number.NaN differentemente da NaN.

Esempi

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

// Casi speciali
Object.is(0, -0);            // false
Object.is(-0, -0);           // true
Object.is(NaN, 0/0);         // true

Polyfill

if (!Object.is) {
  Object.is = function(x, y) {
    // Algoritmo SameValue
    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;
    }
  };
}

Specifiche

Compatibilità coi browser

Vedi anche

• Equality comparisons and sameness (in inglese) — un paragone di tutte e tre le facilitazioni per comparare uguaglianze