除了 null,幾乎所有 JavaScript 資料型別都自帶 valueOf 與 toString 這兩個方法。它們解決的是同一件事的兩面:值運算與字串顯示。但究竟哪個會被呼叫,規則比多數人想像的更微妙。
valueOf 回傳指定物件的原始值,呼叫形式為 object.valueOf()。每個內建物件的實作各不相同:
toString 與 joinMath 與 Error 沒有 valueOf 方法。
toString 把值轉成字串並回傳。以 Boolean 為例,會依原始值回傳 "true" 或 "false";若呼叫對象不是 Boolean,會丟出 TypeError。當 Boolean 物件被放進字串環境時,這個方法會被自動觸發。
<script type="text/javascript"> var boo = new Boolean(false); document.write(boo.valueOf()); // 輸出 false document.write(boo.toString()); // 輸出 "false" </script>
看一個例子:
var aaa = {
i: 10,
valueOf: function() { return this.i + 30; },
toString: function() { return this.valueOf() + 10; }
}
alert(aaa > 20); // true
alert(+aaa); // 40
alert(aaa); // 50
三個結果都不同,因為引擎在背後呼叫了不同的方法。要搞清楚規則,最直觀的方式是在每個方法裡打log(需在裝有 Firebug 的 Firefox 中實驗):
var bbb = {
i: 10,
toString: function() {
console.log('toString');
return this.i;
},
valueOf: function() {
console.log('valueOf');
return this.i;
}
}
alert(bbb); // 10,呼叫 toString
alert(+bbb); // 10,呼叫 valueOf
alert('' + bbb); // 10,呼叫 valueOf ← 意外
alert(String(bbb)); // 10,呼叫 toString
alert(Number(bbb)); // 10,呼叫 valueOf
alert(bbb == '10'); // true,呼叫 valueOf
alert(bbb === '10'); // false,不進行隱式轉換
初看之下結論似乎是「轉字串用 toString,轉數值用 valueOf」,但有兩處不協調:'' + bbb 明明是字串拼接,卻走了 valueOf;而 === 因為不做隱式轉換,兩個方法都不碰。
只重寫 toString 時:
var aa = {
i: 10,
toString: function() {
console.log('toString');
return this.i;
}
}
alert(aa); // 10,toString
alert(+aa); // 10,toString
alert('' + aa); // 10,toString
alert(String(aa)); // 10,toString
alert(Number(aa)); // 10,toString
alert(aa == '10'); // true,toString
行為非常規整:不論做什麼轉換,一律走 toString。
只重寫 valueOf 時:
var bb = {
i: 10,
valueOf: function() {
console.log('valueOf');
return this.i;
}
}
alert(bb); // [object Object]
alert(+bb); // 10,valueOf
alert('' + bb); // 10,valueOf
alert(String(bb)); // [object Object]
alert(Number(bb)); // 10,valueOf
alert(bb == '10'); // true,valueOf
這裡就不規整了。那個 [object Object] 顯然是從 Object.prototype 繼承來的 toString。把它拿掉再看:
Object.prototype.toString = null;
var cc = {
i: 10,
valueOf: function() {
console.log('valueOf');
return this.i;
}
}
alert(cc); // 10,valueOf
alert(+cc); // 10,valueOf
alert('' + cc); // 10,valueOf
alert(String(cc)); // 10,valueOf
alert(Number(cc)); // 10,valueOf
alert(cc == '10'); // true,valueOf
謎底揭開了。
如果只重寫了 toString,物件轉換時會完全無視 valueOf 的存在。但如果只重寫了 valueOf,在需要轉成字串時引擎會優先考慮 valueOf——只有在 toString 徹底不可用的情況下,才會退回繼承而來的預設實作。
至於那個看似反常的字串拼接問題,答案藏在 ECMA-262-5 的 ToPrimitive 操作裡:該操作帶有一個 hint 參數,而在有運算子介入的場景中,valueOf 的優先級本來就高於 toString。重寫方法會改變它們被呼叫的順序,這正是行為看似不一致的根源。