在线文档教程

object.valueOf

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

规范

SpecificationStatusComment
ECMAScript 1st Edition (ECMA-262)StandardInitial 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

浏览器兼容性

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic Support(Yes)(Yes)(Yes)(Yes)(Yes)(Yes)

FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic Support(Yes)(Yes)(Yes)(Yes)(Yes)(Yes)(Yes)