setTimeout 是前端最常被誤用的 API 之一。它表面上只是「延遲執行」,但一旦牽涉到參數傳遞與迴圈變數,就會踩進 JavaScript 作用域的深坑。
多數教學文件只示範不帶參數的呼叫,於是很多人會直接把變數寫進去。最保險的方式,其實是用一個匿名函式把呼叫包起來:
function showTip(msg) {
alert(msg);
}
function timedMsg() {
var a = 'dd';
setTimeout(function () {
showTip(a);
}, 3000);
}
按下按鈕後約三秒,提示框才跳出來。關鍵在於:匿名函式形成了閉包,所以 a 會在真正被執行的那一刻才取值。
把同樣的寫法搬進 for 迴圈,問題立刻浮現:
for (var i = 0; i < points.length; i++) {
setTimeout(function () {
addMarker(points[i], value);
}, 2000 * i);
}
結果所有計時器都只畫出最後一個座標。原因不是 setTimeout 壞了,而是 var 宣告的 i 屬於函式作用域:迴圈早已跑完,i 停在 points.length,等到兩秒、四秒、六秒後各計時器陸續觸發時,讀到的都是同一個「已經結束」的 i。
for (var i = 0; i < points.length; i++) {
(function (index) {
setTimeout(function () {
addMarker(points[index], value);
}, 2000 * index);
})(i);
}
ES6 的 let 具備區塊作用域,每一圈迴圈都會產生獨立綁定,問題自然消失:
for (let i = 0; i < points.length; i++) {
setTimeout(() => addMarker(points[i], value), 2000 * i);
}
其實 setTimeout 從第三個參數起就支援傳值,只是少有人知道:
setTimeout(addMarker, 2000, points[0], value);
若不想一次排入全部計時器,可以讓函式做完一件事後再排下一件,並用 clearTimeout 收尾:
var timer;
var replayIndex = 0;
function replay(points, value) {
if (replayIndex < points.length) {
addMarker(points[replayIndex], value);
replayIndex++;
timer = setTimeout(function () {
replay(points, value);
}, 1000);
} else {
replayIndex = 0;
clearTimeout(timer);
}
}
這種寫法節奏可控、隨時能中止,缺點是每步都固定等一秒,不會與起始時間精準對齊。