object.valueOf

valueOf() 方法返回指定对象的原始值。

语法

object.valueOf()

返回值

返回值为该对象的原始值。

描述

JavaScript调用valueOf方法将对象转换为原始值。你很少需要自己调用valueOf方法；当遇到要预期的原始值的对象时，JavaScript会自动调用它。

默认情况下，valueOf方法由Object后面的每个对象继承。 每个内置的核心对象都会覆盖此方法以返回适当的值。如果对象没有原始值，则valueOf将返回对象本身。

JavaScript的许多内置对象都重写了该函数，以实现更适合自身的功能需要。因此，不同类型对象的valueOf()方法的返回值和返回值类型均可能不同。

覆盖自定义对象的 valueOf方法

你可以创建一个取代 valueOf方法的函数，你的方法必须不能传入参数。

假设你有一个对象类型MyNumberType，你想valueOf为它创建一个方法。以下代码将用户定义的函数分配给对象的valueOf方法：

MyNumberType.prototype.valueOf = function() { return customPrimitiveValue; };

使用前面的代码，任何时候MyNumberType在一个上下文中使用类型的对象时，JavaScript都会自动调用前面代码中定义的函数。

对象的valueOf方法通常由JavaScript调用，但您可以自己调用它，如下所示：

myNumberType.valueOf()

注意：字符串上下文中的对象通过toString()方法进行转换，这与将String对象转换为使用的字符串基元不同valueOf。所有对象都有一个字符串转换，如果只是“ [objecttype]”。但是许多对象不会转换为数字，布尔值或函数。

示例

使用valueOf

function MyNumberType(n) {
    this.number = n;
}

MyNumberType.prototype.valueOf = function() {
    return this.number;
};

var myObj = new MyNumberType(4);
myObj + 3; // 7

规范

Specification	Status	Comment
ECMAScript 1st Edition (ECMA-262)	Standard	Initial definition. Implemented in JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)The definition of 'Object.prototype.valueOf' in that specification.	Standard	​
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'Object.prototype.valueOf' in that specification.	Standard	​
ECMAScript Latest Draft (ECMA-262)The definition of 'Object.prototype.valueOf' in that specification.	Living Standard	​

浏览器兼容性

Feature	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari
Basic Support	(Yes)	(Yes)	(Yes)	(Yes)	(Yes)	(Yes)

Feature	Android	Chrome for Android	Edge mobile	Firefox for Android	IE mobile	Opera Android	iOS Safari
Basic Support	(Yes)	(Yes)	(Yes)	(Yes)	(Yes)	(Yes)	(Yes)