Object.is()
Object.is()
メソッドは 2 つの値が同一値であるかどうかを判定します。
構文
Object.is(value1, value2);
引数
value1
-
比較する 1 つ目の値。
value2
-
比較する 2 つ目の値。
返値
Boolean
で、 2 つの引数が同一値であるかどうかを表します。
解説
Object.is()
は 2 つの値が同一値であるかどうかを判定します。2 つの値が以下の規則の一つに当てはまる場合に同一となります。
このメソッドは ==
演算子による等値比較と同じものではありません。 ==
演算子は等値性比較の前に (同じ型でなければ) 両辺に対して様々な型変換を適用します (結果、例えば "" == false
は true
に評価されます) が、Object.is
は両辺どちらの値にも型変換を行いません。
また ===
演算子による同値比較とも同じものでもありません。 ===
演算子は (そして ==
演算子も) 数値 -0
と +0
は同じものとして扱い、 Number.NaN
と NaN
は異なるものとして扱います。
例
Object.is の使用
Object.is('foo', 'foo'); // true
Object.is(window, window); // true
Object.is('foo', 'bar'); // false
Object.is([], []); // false
var foo = { a: 1 };
var bar = { a: 1 };
Object.is(foo, foo); // true
Object.is(foo, bar); // false
Object.is(null, null); // true
// 特殊なケース
Object.is(0, -0); // false
Object.is(-0, -0); // true
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;
}
}
});
}
仕様書
Specification |
---|
ECMAScript Language Specification # sec-object.is |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- 等値比較と同一性 — 標準搭載されている 3 つの同一性比較支援機能の比較