setTimeout() 是最常被使用、也最常被用錯的 API 之一。特別是「想傳參數給計時器裡的函式」這件事,寫錯了會靜默失效,很難 debug。本文從一個計時器範例出發,把用法與陷阱一次講完。
效果圖:

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312" />
<title>setTimeout 計時器</title>
<script type="text/javascript">
var timer; // 計時器識別碼,宣告在全域以便 stop 使用
var i = 0; // 已經過的秒數
// 開始計時
function start() {
var obj = document.getElementById("result");
var str = "該程序已經運行了" + i + "秒!";
i++; // 等價於 i = i + 1
obj.value = str; // 表單元素的內容用 value 寫入
// 10 毫秒後再次呼叫自己,形成循環
timer = window.setTimeout("start()", 10);
}
// 停止計時
function stop() {
window.clearTimeout(timer);
}
</script>
</head>
<body>
<input type="button" id="result" value="該程序已經運行了0秒!" /><br />
<input type="button" onclick="start()" value="開始" />
<input type="button" onclick="stop()" value="停止" />
</body>
</html>
這裡有兩個實務要點。第一,timer 必須存在外層。如果宣告在 start() 內部,stop() 就拿不到它的識別碼,無從取消。第二,寫入內容的方式取決於元素類型。表單元素用 value,其餘標記用 innerHTML,兩者不能混用。
setTimeout(code, millisec) 有兩個必要參數:
code:要執行的函式,或一段 JavaScript 程式碼字串。
millisec:執行前的等待毫秒數。
請記住:setTimeout 只執行一次。若要重複執行,得用 setInterval(),或像上面範例那樣讓 code 自己再呼叫一次 setTimeout。這也是為什麼「計時器」通常要自己接成迴圈。
<html>
<head>
<script type="text/javascript">
function timedMsg() {
var t = setTimeout("alert('5 seconds!')", 5000);
}
</script>
</head>
<body>
<form>
<input type="button" value="Display timed alert box!" onClick="timedMsg()">
</form>
<p>Click on the button above. An alert box will be displayed after 5 seconds.</p>
</body>
</html>
假設訊息存在一個變數裡,希望 1 秒後跳出來:
var msg = '1s has passed!';
這兩種寫法都不會如 your 預期:
setTimeout(alert(msg), 1000); // alert(msg) 會被立即執行,計時形同虛設
setTimeout("alert(msg)", 1000); // 報錯 msg is not defined
原因值得說明。計時器會努力把你的 code 轉換成一個函式物件:第一種寫法裡,alert(msg) 在傳参當下就已經被執行並回傳 undefined,計時器拿到的是空東西;第二種寫法雖然成功包裝出函式,但字串形式的程式碼是在全域作用域中被求值的,那時候它看不到區域的 msg,於是報未定義。
推薦的解法是傳入匿名函式:
var msg = '1s has passed!';
setTimeout(function () {
alert(msg);
}, 1000);
這樣第一個參數是一個真正的函式物件,它透過閉包持有 msg 的參考,帶參問題自然解決。如果有多個參數要傳,也可以利用第三個起的額外參數:setTimeout(fn, 1000, arg1, arg2)(舊版 IE 不支援,需要時可改用 fn.bind(null, arg1, arg2))。
function clockon(bgclock) {
var now = new Date();
var year = now.getFullYear();
var month = now.getMonth() + 1;
var date = now.getDate();
var day = now.getDay();
var hour = now.getHours();
var minu = now.getMinutes();
var sec = now.getSeconds();
// 補零,讓 9 顯示成 09
if (month < 10) month = "0" + month;
if (date < 10) date = "0" + date;
if (hour < 10) hour = "0" + hour;
if (minu < 10) minu = "0" + minu;
if (sec < 10) sec = "0" + sec;
var week;
switch (day) {
case 1: week = "星期一"; break;
case 2: week = "星期二"; break;
case 3: week = "星期三"; break;
case 4: week = "星期四"; break;
case 5: week = "星期五"; break;
case 6: week = "星期六"; break;
default: week = "星期日"; break;
}
var time = year + "年" + month + "月" + date + "日" + week + " " + hour + ":" + minu + ":" + sec;
if (document.all) {
bgclock.innerHTML = "系統公告:[" + time + "]";
}
// 200 毫秒後再次呼叫自己,維持連續更新
var timer = setTimeout("clockon(bgclock)", 200);
}
注意 getMonth() 回傳的是 0 到 11,所以必須加一才是人類看懂的月份;getDay() 回傳 0 代表星期日,因此 switch 的 default 落在週日上。這些零起的索引是日期處理中最常見的疏漏來源。
總結一句:setTimeout 只跑一次,需要循環就自己接;要帶參數就傳函式,不要傳字串。