JavaScript

Object.is()メソッド

 編集:2022.07.28 by T.A.

2 つの値が同一値であるかどうかを判定します。

Object.is(value1, value2);
value1 比較する 1 つ目の値。
value2 比較する 2 つ目の値。
戻り値

Boolean で、2 つの引数が同一値であるかどうかを表します。

解説

Object.is() は 2 つの値が同一値であるかどうかを判定します。2 つの値が以下の規則の一つに当てはまる場合に同一となります。

このメソッドは == 演算子による等値比較と同じものではありません。== 演算子は等値性比較の前に(同じ型でなければ)両辺に対して様々な型変換を適用します(結果、例えば "" == false は true に評価されます)が、Object.is は両辺どちらの値にも型変換を行いません。

また === 演算子による同値比較とも同じものでもありません。=== 演算子は(そして == 演算子も)数値 -0+0 は同じものとして扱い、Number.NaNNaN は異なるものとして扱います。

Object.is の使用
D=Object.is('foo', 'foo');	//=true
D=Object.is(window, window);	//=true
D=Object.is('foo', 'bar');	//=false
D=Object.is([], []);	//=false

var foo = { a: 1 };
var bar = { a: 1 };
D=Object.is(foo, foo);	//=true
D=Object.is(foo, bar);	//=false

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

// 特殊なケース
D=Object.is(0, -0);	//=false
D=Object.is(-0, -0);	//=true
D=Object.is(NaN, 0/0);	//=true
ポリフィル
if (!Object.is) {
  Object.defineProperty(Object, "is", {
    value: function (x, y) {
      // 同値アルゴリズム
      if (x === y) { // ステップ 1 から 5、および 7 から 10
        // ステップ 6.b から 6.e までの場合: +0 != -0
        return x !== 0 || 1 / x === 1 / y;
      } else {
        // ステップ 6.a の場合: NaN == NaN
        return x !== x && y !== y;
      }
    }
  });
}

テスト