Object.prototype.valueOf()

尝试一下

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

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

const object1 = new MyNumberType(4);

console.log(object1 + 3);
// Expected output: 7

语法

valueOf()

参数

无。

返回值

转换成对象的 this 值。

描述

JavaScript 调用 valueOf 方法来将对象转换成基本类型值。你很少需要自己调用 valueOf 方法；当遇到需要基本类型值的对象时，JavaScript 会自动的调用该方法。

强制数字类型转换和强制基本类型转换优先会调用该方法，而强制字符串转换会优先调用 toString()，并且 toString() 很可能返回字符串值（甚至对于 Object.prototype.toString() 基本实现也是如此），因此在这种情况下不会调用 valueOf()。

从 Object.prototype 继承的所有对象（即，除了null 原型对象之外的所有对象）都继承了 toString() 方法。Object.prototype.valueOf() 的基本实现被有意设计为无用的：返回一个对象；其返回值将永远不会被任何基本类型转换算法使用。许多内置对象重写此方法以返回适当的基本类型值。创建自定义对象时，可以重写 valueOf() 来调用自定义方法，以便将自定义对象转换为基本类型值。通常，valueOf() 用于返回对对象具有意义的值——与 toString() 不同，它不需要字符串。或者，你可以添加一个 [Symbol.toPrimitive]() 方法，该方法允许对转换过程进行更多控制，并且对于任何类型的转换，始终优先于 valueOf 或 toString。

示例

使用 valueOf()

基本的 valueOf() 方法返回 this 值本身，如果尚未转换为对象，则转换成对象。因此，任何基本类型转换算法都不会使用它的返回值。

const obj = { foo: 1 };
console.log(obj.valueOf() === obj); // true

console.log(Object.prototype.valueOf.call("primitive"));
// [String: 'primitive']（一个包装对象）

重写自定义对象的 valueOf

你可以创建一个要调用的函数来代替默认的 valueOf 方法。你的函数不应该接受任何参数，因为在类型转换期间调用它时不会传递任何参数。

例如，你可以将 valueOf 方法添加到自定义类 Box 中。

class Box {
  #value;
  constructor(value) {
    this.#value = value;
  }
  valueOf() {
    return this.#value;
  }
}

有了前面的代码，任何时候在将 Box 类型的对象表示为基本类型值（但不是特定的字符串）的上下文中使用时，JavaScript 都会自动调用前面代码中定义的函数。

const box = new Box(123);
console.log(box + 456); // 579
console.log(box == 123); // true

对象的 valueOf 方法通常由 JavaScript 调用，但你可以按照如下方式自己调用它：

box.valueOf();

对对象使用一元加运算符

一元加（+）对其操作数进行强制数字转换，对于大多数没有 [Symbol.toPrimitive]() 的对象，这意味着调用其 valueOf()。但是，如果对象没有自定义的 valueOf() 方法，则基本实现将导致忽略 valueOf()，而使用 toString() 的返回值。

+new Date(); // 当前时间戳；与 new Date().getTime() 相同
+{}; // NaN（toString() 返回 "[object Object]"）
+[]; // 0（toString() 返回一个空的字符串列表）
+[1]; // 1（toString() 返回 "1"）
+[1, 2]; // NaN（toString() 返回 "1,2"）
+new Set([1]); // NaN（toString() 返回 "[object Set]"）
+{ valueOf: () => 42 }; // 42

规范

浏览器兼容性

参见

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