setTimeout 是 JavaScript 非同步觀念的起點:它不會讓程式「停下來等」,而是把指定的函式排入佇列,計時結束後再執行。以下範例點擊按鈕後,會等三秒才跳出 alert。
<!DOCTYPE html>
<html>
<body>
<p>Click the button to wait 3 seconds, then alert "Hello".</p>
<button onclick="myFunction()">Try it</button>
<script>
function myFunction() {
setTimeout(function () { alert("Hello"); }, 3000);
}
</script>
</body>
</html>
時間單位是毫秒。3000 就是 3 秒,1000 是 1 秒。
它是「至少」這麼久,不是「正好」。瀏覽器只在主執行緒空閒時才會執行排到期的回呼,若同時有長時間的同步運算,實際觸發時間會往後延。背景分頁更是可能被瀏覽器主動降頻到每分鐘才跑一次。
第一個參數也可以傳字串,但請不要這樣做。setTimeout("alert('hi')", 1000) 相當於用 eval 執行,既慢又不安全,而且字串中看不到你想用的區域變數。永遠傳函式。
回傳值是計時器 ID,用來取消。搭配 clearTimeout 就能實作「取消」功能:
var timer = setTimeout(function () { alert("不會出現"); }, 3000);
clearTimeout(timer); // 在觸發前取消
// 需要傳參數給回呼時,用第三個參數之後的傳入
setTimeout(function (name) { alert("Hello, " + name); }, 1000, "sheila");
最後提醒:setTimeout(fn, 0) 常用來「把工作推到下一輪」,但它不等於同步執行,也不保證 0 毫秒;若只是想在 DOM 更新後再做事,搭配 requestAnimationFrame 或 queueMicrotask 會更貼近實際需求。