寫 JS 時經常需要延遲執行某段邏輯,而 setTimeout 的第二個參數若傳字串,就很容易踩坑。本文記錄一次實際的除錯過程,以及用閉包一勞永逸的解法。
原本的程式碼長這樣:
var msgalert = "test";
function TestAlert(msg) {
alert(msg);
}
$(document).ready(function () {
$("#btnCancel").click(function (e) {
setTimeout("TestAlert(" + msgalert + ")", 1000);
});
});
點了按鈕,對話框卻死活不出來。盯著程式碼看了很久都找不出原因,最後才發現——少了一對單引號。
問題在於 setTimeout 的字串形式會把字串當成 JavaScript 程式碼來 eval。拼出來的結果是 TestAlert(test),而 test 被當成一個未定義的變數,執行時直接丟 ReferenceError,而且這個錯誤發生在 eval 的內容裡,堆疊追蹤幾乎無助於定位。
$(document).ready(function () {
$("#btnCancel").click(function (e) {
setTimeout("TestAlert('" + msgalert + "')", 1000);
});
});
補上引號後確實能跑了。但這種寫法的問題不只是容易出錯,而是出錯後難以察覺:字串拼接時漏一個引號、多一個括號,都是常有的事,而錯誤訊息又不指向你的原始碼行號。
把延遲邏輯獨立成一個函式,直接傳函式參照而非字串:
var msgalert = "test";
function dalayAlert(msg, time) {
setTimeout(
TestAlert(msg),
time
);
}
function TestAlert(msg) {
alert(msg);
}
$(document).ready(function () {
$("#btnCancel").click(function (e) {
dalayAlert(msgalert, 1000);
});
});
這樣一来,參數透過閉包被保留下來,不需要任何字串拼接。程式碼更短,錯誤檢查也容易得多——因為它現在是普通的函式呼叫,任何型別錯誤都會在正常的位置抛出,堆疊追蹤完整可用。
第一,setTimeout 的第一個參數本來就支援直接傳函式,字串形式是為了相容遠古寫法而保留的,永遠不該在新程式碼中使用。除了除錯困難,它還繞過了 eval 的相關安全限制。
第二,閉包在迴圈中要特別小心。如果在 for 迴圈裡用 var 宣告計數變數並在 setTimeout 中引用它,所有回呼都會拿到迴圈結束後的最終值。這時候要用 IIFE 或改用 let 來固定每次迭代的值,否則就會出現「印出來的數字全都一樣」的經典問題。