★ wanayoo — archive 1999 https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Object/valueOfNouvelle recherche | Portail wanayoo
Your Search Results

    Object.prototype.valueOf()

    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)

    See also

    Document Tags and Contributors

    Contributors to this page: teoli, mixture
    Last updated by: teoli,