JavaScript valueOf() 是 Object 的原型方法,它定义在 Object.prototype 对象上,所有 Object 的实例对象都会继承 valueOf() 方法。
valueOf() 方法能够返回对象的值。JavaScript 自动类型转换时会默认调用 valueOf() 原型方法。Object 对象默认 valueOf() 方法返回值与 toString() 方法返回值相同,但是部分类型对象重写了 valueOf() 方法。
valueOf() 的语法格式如下:
返回值:返回该对象的原始值。
Date 对象的 valueOf() 原型方法返回值是当前日期对象的毫秒数。
var o = new Date(); //对象实例
console.log(o.toString()); //返回当前时间的UTC字符串
console.log(o.valueOf()); //返回距离1970年1月1日午夜之间的毫秒数
console.log(Object.prototype.valueOf.apply(o)); //默认返回当前时间的UTC字符串
当 String、Number 和 Boolean 对象具有明显的原始值时,它们的 valueOf() 原型方法会返回合适的原始值。
在自定义类型时,除了重写 toString() 方法外,也可以重写 valueOf() 原型方法。这样当读取自定义对象的值时,就能避免返回的值总是 "[object Object]"。
function Point (x, y) { //自定义数据类型
this.x = x;
this.y = y;
}
Point.prototype.valueOf = function () { //自定义Point数据类型的valueOf()原型方法
return "(" + this.x + "," + this.y + ")";
}
var p = new Point(26, 68);
console.log(p.valueOf()); //返回当前对象的值"(26,68)"
console.log(Object.prototype.valueOf.apply(p)); //默认返回值为"[object Object]"
在特定环境下进行数据类型转换时(如把对象转换为字符串),valueOf() 原型方法的优先级要比 toString() 方法的优先级高。因此,如果一个对象的 valueOf() 原型方法返回值和 toString() 方法返回值不同,且希望转换的字符串为 toString() 方法的返回值时,就必须明确调用对象的 toString() 方法。
在下面示例中,当获取自定义类型的对象 p 时,console.log() 方法会首先调用 valueOf() 原型方法,而不是 toString() 方法,如果需要获取该对象的字符串表示,则必须明确调用对象的 toString() 方法。
function Point (x, y) { //自定义数据类型
this.x = x;
this.y = y;
}
Point.prototype.valueOf = function () { //自定义Point数据类型的valueOf()方法
return "(" + this.x + "," + this.y + ")";
}
Point.prototype.toString = function () { //自定义Point数据类型的toString()方法
return "[object Point]";
}
var p = new Point(26,68); //实例化对象
console.log("typeof p = " + p); //默认调用valueOf()方法进行类型转换
console.log("typeof p = " + p.toString()); //直接调用toString()方法进行类型转换