toString() 能把 Number 物件轉換成字串並回傳。它真正的價值在於那個很少被注意到的參數:可以指定輸出的進位。
NumberObject.toString(radix)
| 參數 | 說明 |
|---|---|
| radix | 可選。指定用來表示數字的基數,也就是進位制,必須是 2 到 36 之間的整數。若省略,預設使用 10(十進位)。 要注意的是,當這個參數是 10 以外的值時,ECMAScript 標準允許各實作自行決定回傳值——實務上主流瀏覽器行為一致,但這是標準留的伏筆。 |
var a = new Number(3); console.log(a.toString());
輸出:
3
var n = 255; console.log(n.toString(2)); // 11111111,二進位 console.log(n.toString(8)); // 377,八進位 console.log(n.toString(16)); // ff,十六進位 console.log(n.toString(36)); // 73,三十六進位
十六進位常用在顏色處理上,例如把 RGB 值組合成 CSS 色碼:
function toHex(n) {
return n.toString(16).padStart(2, '0');
}
var hex = '#' + toHex(255) + toHex(105) + toHex(180); // "#ff69b4"
這裡的 padStart(2, '0') 是必要的:當某個色通道的值小於 16 時,toString(16) 只會回傳一個字元(例如 5 變成 "5" 而非 "05"),補零才能湊成完整的兩位數。
toString(radix) 負責「數字 → 指定進位字串」,而 parseInt(str, radix) 負責反過來。兩者正好互逆,可以組合成任意進位之間的轉換:
// 二進位轉十六進位
parseInt("11111111", 2).toString(16); // "ff"
// 十六進位轉十進位
parseInt("ff", 16); // 255
toString() 是繼承自 Object 的方法,若在 null 或 undefined 上呼叫會丟出 TypeError:
var value = null; value.toString(); // TypeError
處理可能為空的值時,先確認型別再呼叫,或用 String(value) 這種更寬容的轉換方式。
另外,數字字面本例在某些舊引擎上不能直接接 .,寫 3.toString() 會被解析成語法錯誤,需要寫成 (3).toString() 或 3..toString()。現代引擎多已修正這個問題,但加上括號仍是比較保險的習慣。