object.valueOf()
參數 object 為必填,代表任一內建的 JScript 物件。
關鍵觀念:每個內建物件各自定義了自己的 valueOf。它並不是一套共用邏輯,而是各物件依自身語意回傳「最原始的表示」。以下是對照表:
| 物件 | 回傳值 |
|---|---|
| Array | 把各元素轉為字串後以逗號串接,行為等同 Array.toString 與 Array.join |
| Boolean | 布林值本身 |
| Date | 從 1970 年 1 月 1 日午夜起算的 UTC 毫秒數 |
| Function | 函數本身 |
| Number | 數字值 |
| Object | 物件本身(預設情況) |
| String | 字串值 |
特別注意:Math 與 Error 物件並沒有 valueOf 方法。
Array 物件、Boolean 物件、Date 物件、Function 物件、Number 物件、Object 物件、String 物件。
絕大多數情況下你不會直接呼叫 valueOf(),因為 JavaScript 在需要把物件轉成原始值時會自動呼叫它。最常見的場景是運算與比較:
var d = new Date();
var later = d + 86400000; // 這裡自動走 valueOf,得到毫秒數相加
var n = new Number(5);
console.log(n * 2); // 10,先取原始值 5
另一個用途是自訂型別轉換。當你建立自己的物件並希望它能參與數值運算時,掛上一個 valueOf 就能定義它的原始值:
function Money(yuan) { this.yuan = yuan; }
Money.prototype.valueOf = function () { return this.yuan; };
var a = new Money(100);
console.log(a + 50); // 150
要留意的是,當運算涉及字串串接時,JavaScript 會優先採用 toString() 而非 valueOf()。若你想完全掌控轉換行為,兩個方法通常都要一起定義。