Сводка

МетодvalueOf() возвращает примитивное значение указанного объекта.

Синтаксис

object.valueOf()

Описание

JavaScript вызывает методvalueOf для преобразования объекта в примитивное значение. Вам редко потребуется вызывать методvalueOf самостоятельно; JavaScript автоматически вызывает его при обнаружении объекта, когда ожидается примитивное значение.

По умолчанию, методvalueOf наследуется каждым объектом, произошедшим отObject. Каждый встроенный объект ядра переопределяет этот метод, возвращая подходящее значение. Если объект не имеет примитивного значения,valueOf возвращает сам объект, который отображается как:

[object Object]

Вы можете использоватьvalueOf в своём коде для преобразования встроенных объектов в примитивное значение. Когда вы создаёте пользовательский объект, вы можете переопределить методObject.prototype.valueOf(), чтобы вызывать собственный метод вместо метода по умолчанию изObject.

ПереопределениеvalueOf в пользовательских объектах

Вы можете создать функцию, вызываемую вместо методаvalueOf по умолчанию. Ваша функция не должна принимать аргументов.

Предположим, у вас есть объект типаmyNumberType и вы хотите создать для него методvalueOf. Следующий код присваивает определённую пользователем функцию методуvalueOf объекта:

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

Начиная с этого места в вашем коде, в любое время, когда объект типаmyNumberType будет использоваться в контексте, где он должен быть представлен примитивным значением, JavaScript будет автоматически вызывать функцию, определённую в этом коде.

Метод объектаvalueOf обычно вызывается движком JavaScript, но вы можете вызвать его и самостоятельно, как показано ниже:

myNumber.valueOf();

Примеры

Пример: использованиеvalueOf

var o = new Object();myVar = o.valueOf(); // [object Object]

Спецификации

Совместимость с браузерами

Смотрите также

• Object.prototype.toString()
• parseInt()