Summary
Метод valueOf() возвращает примитивное значение указанного объекта.
Синтаксис
object.valueOf()
Описание
JavaScript вызывает метод valueOf для преобразования объекта в примитивное значение. Вам нечасто придется вызывать метод valueOf вручную; JavaScript автоматически вызывает его в случаях когда объект оказывается на позиции примитивного значения.
По умолчанию метод valueOf Наследуется каждым объектом от Object. Все встроенные объекты перегружают этот метод чтобы возвращать соответствующие значения. Если у объекта нет примитивного значения, valueOf возвращает сам объект, что отображается как:
[object Object]
Вы можете вызывать valueOf в своем коде для преобразования встроенных объектов в примитивные значения. Когда вы создаете собственный объект, вы можете перегрузить Object.prototype.valueOf() собственным методом взамен того что уже есть в Object.
Перегрузка valueOf в пользовательских объектах
You can create a function to be called in place of the default valueOf method. Your function must take no arguments.
Suppose you have an object type myNumberType and you want to create a valueOf method for it. The following code assigns a user-defined function to the object's valueOf method:
myNumberType.prototype.valueOf = function () { return customPrimitiveValue; };
With the preceding code in place, any time an object of type myNumberType is used in a context where it is to be represented as a primitive value, JavaScript automatically calls the function defined in the preceding code.
An object's valueOf method is usually invoked by JavaScript, but you can invoke it yourself as follows:
myNumber.valueOf()
Note: Objects in string contexts convert via the toString() method, which is different from String objects converting to string primitives using valueOf. All objects have a string conversion, if only "[object type ]". But many objects do not convert to number, boolean, or function.
Examples
Example: Using valueOf
o = new Object(); myVar = o.valueOf(); // [object Object]
Specifications
| Specification | Status | Comment |
|---|---|---|
| ECMAScript 1st Edition. Implemented in JavaScript 1.1 | Standard | Initial definition. |
| ECMAScript 5.1 (ECMA-262) The definition of 'Object.prototype.valueOf' in that specification. |
Standard | |
| ECMAScript 6 (ECMA-262) The definition of 'Object.prototype.valueOf' in that specification. |
Draft |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |