返回探索
指南VibeFix 内容整理更新于 2026年11月21日

不是立刻做,是到了时间再做:JavaScript 定时器 setTimeout 与 setInterval

setTimeout 管一次,setInterval 管反复,但 delay 只保证“最少等这么久”:0 也不立刻、后台标签页还会更晚、超过 2147483647 会溢出。本文按 MDN 的 setTimeout 与 setInterval 两篇官方文档讲清楚:异步返回、传参、delay 的数字规矩、嵌套 4 毫秒、clearTimeout 与 clearInterval、递归 setTimeout、this 丢失与字符串参数,另附虚构咖啡馆点单页一个月 100 次定时器翻车的分布。

真实照片:一只黑色双铃闹钟放在木质桌面上,暖色晨光,表盘显示约两点二十八分

先把这篇的边界说清楚。站里已经有不少 JavaScript 基础指南:事件循环指南讲过单线程里任务怎么排队,Promise 与 async 讲过怎么等一个异步结果,搜索框防抖指南讲过等用户停下来再搜一次,定时任务指南讲过服务端跑 cron 的四种做法。这篇不讲它们,只讲一件事:浏览器里最常用的两个定时器,setTimeout 与 setInterval,一个管“过一会儿做一次”,一个管“每隔一会儿做一次”。下面用到的“青石咖啡馆”还是那个虚构的练手项目:一个帮街边咖啡馆做点单的网页小工具。之前几篇讲的是它的点单页怎么做决定、怎么循环、怎么取数,这回讲的是它的两件“过一会儿”的事:顾客下单后过几秒在屏幕上闪一下“已接单,请稍等”,取餐屏每隔半分钟刷新一次号码。本文所有以它为例的操作、代码和数字,都是为了讲清楚做法编出来的,不是真实记录。所有关于定时器的语法与行为,都来自 MDN 的《Window: setTimeout() method》与《Window: setInterval() method》两篇官方文档,来源见每篇的 meta 信息与 evidence 记录。读完这篇,你应该能做到四件事:会用 setTimeout 约一次、会用 setInterval 约反复、知道 delay 这个数字到底有哪些规矩、知道定时器最常见的坑长什么样。事件循环指南里留出的“怎么约时间”,就是这篇要讲的。

第一步:先看问题,点单页有两件“过一会儿”的事

青石咖啡馆的点单页上有两件“过一会儿”的事。第一件,顾客点完单、按下“下单”按钮,页面不能立刻就把“已接单”几个字钉死在那里,得过三秒再闪一下“已接单,请稍等”,让顾客确认单子真的发出去了。第二件,取餐屏上的号码不能只画一次就停在那里,得每三十秒刷新一次,新的号出来了就换上去。这两件事有个共同点:都不能“现在立刻做”,也不能“一直等着做”。如果用循环干等,页面会被卡住,按钮点不动、字也打不上去,顾客只能干看着转圈。定时器的办法是反过来的:你告诉浏览器“过多久叫我一次”或者“每隔多久叫我一次”,然后就把手松开,该干什么干什么,时间到了浏览器会来叫你。setTimeout 管前一种:只叫一次;setInterval 管后一种:每隔一阵就叫一次。这一节先记住这个分工:一次用 setTimeout,反复用 setInterval,两个都是“约时间”,不是“等时间”。

第二步:setTimeout,一次,调完立刻返回

setTimeout 的写法是 setTimeout(func, delay),第一个参数是要跑的函数,第二个参数是等多少毫秒。MDN 的原话是:setTimeout 是一个异步函数,它会在安排好回调函数之后立刻返回,不会“等着”,不会卡住 setTimeout 后面的代码。MDN 的例子最能说明这一点:

setTimeout(() => {
  console.log("this is the first message");
}, 5000);

setTimeout(() => {
  console.log("this is the second message");
}, 3000);

setTimeout(() => {
  console.log("this is the third message");
}, 1000);

// Output:
// this is the third message
// this is the second message
// this is the first message

三个 setTimeout 按先 5000、再 3000、最后 1000 的顺序写,输出却是反过来的:等 1 秒的那句先出来,等 3 秒的第二,等 5 秒的最后。MDN 的解释是:因为前面的调用等得更久,所以回调按相反的顺序执行。如果 setTimeout 会卡住等回调跑完,输出就会按写的顺序来。还有一个返回值要记住:setTimeout 会返回一个 ID,在浏览器里是一个正整数,这个 ID 就是这个定时器的“号牌”,后面取消它要靠这个号牌。MDN 的原话是:在同一个全局环境里,只要原来的定时器还活着,它的 ID 就保证不会被新的定时器重用;但不同的全局环境(比如不同的窗口或者 worker)各有各的号牌池子。咖啡馆的例子:顾客下单后,setTimeout(showAccepted, 3000),三秒后 showAccepted 跑一次,把“已接单,请稍等”闪出来,完事。

第三步:给回调传参,不用再包一层闭包

setTimeout 还能直接给回调函数传参数,写法是 setTimeout(func, delay, param1, param2),delay 后面跟的每一个参数,都会原样传给 func。MDN 的例子是两个按钮配一个输出框:

let timeoutID;

function setOutput(outputContent) {
  document.querySelector("#output").textContent = outputContent;
}

function delayedMessage() {
  setOutput("");
  timeoutID = setTimeout(setOutput, 2 * 1000, "That was really slow!");
}

function clearMessage() {
  clearTimeout(timeoutID);
}

document.getElementById("show").addEventListener("click", delayedMessage);
document.getElementById("cancel").addEventListener("click", clearMessage);

点“Show”按钮,两秒后输出框里出现 “That was really slow!”;点“Cancel”按钮,还没到两秒就把这次约好取消掉,字就不会出现。这里的 setTimeout(setOutput, 2 * 1000, "That was really slow!") 就是传参的写法:第三个参数直接给了 setOutput 要用的那句话,不用再写一个箭头函数包一层。setInterval 的传参写法一模一样,MDN 的例子是 setInterval(myCallback, 500, "Parameter 1", "Parameter 2"),myCallback 收到 "Parameter 1" 和 "Parameter 2"。我的判断是:参数只有一个、又是现成的字符串或数字时,直接用第三个参数传最干净;参数要现算、或者要传对象里现取的值时,再包一层箭头函数,别为了省一行把代码写绕了。

第四步:delay 的数字规矩,默认 0、负数按 0、字符串会被悄悄转成数字

delay 这个数字有几条硬规矩,MDN 在两篇文档里都写明了。第一,不传 delay 就按 0 算。第二,负数和 0 一个待遇。第三,也是最容易踩的一条:如果传的不是数字,浏览器会悄悄把它转成数字,不报错。MDN 的例子是:传字符串 "1000" 也能跑,因为它会被转成数字 1000,一秒后执行;但传 "1 second" 就出事了,它会被转成数字 0,于是回调立刻就跑,写代码的人还以为自己约了一秒。MDN 的原话是:很多时候这种隐式类型转换会带来出乎意料的结果,所以别用字符串当 delay,永远用数字。第四,delay 会被转成 32 位有符号整数,最大值是 2147483647 毫秒,大约 24.8 天,超过这个数会溢出。MDN 给了两个例子:setTimeout(() => console.log("hi!"), 2 ** 32 - 5000) 会立刻执行,因为 2 的 32 次方减 5000 溢出成了负数;setTimeout(() => console.log("hi!"), 2 ** 32 + 5000) 会在大约 5 秒后执行,因为它溢出后剩下了 5000。MDN 还补了一句:在 Node.js 里,任何超过 2147483647 毫秒的定时器都会立刻执行。咖啡馆的例子:取餐屏刷新写 setInterval(refreshBoard, 30 * 1000),数字是算出来的 30000,清清楚楚;写 setInterval(refreshBoard, "30秒") 就等着出怪事,字符串 "30秒" 转成数字是 NaN 还是 0,全看浏览器的转换规则,别赌。

第五步:延迟只是“最少等这么久”,不是“准时”

这是整篇最重要的一句话:delay 说的是“最少等这么久”,不是“到了这个时间准时跑”。MDN 用了整整一节讲“为什么超时会比设定的晚”。先看最常见的情形:delay 写 0 也不代表立刻跑。MDN 的例子是:

function foo() {
  console.log("foo has been called");
}

setTimeout(foo, 0);
console.log("After setTimeout");

// Output:
// After setTimeout
// foo has been called

哪怕 delay 是 0,foo 也得排到下一轮,等当前正在跑的代码跑完了才轮到它。MDN 的原话是:哪怕 setTimeout 的 delay 是 0,它也被放进队列、等下一次机会才跑,而不是立刻跑;当前正在执行的代码必须先跑完,队列里的函数才能执行,所以实际的执行顺序可能和你想的不一样。第二种情形是主线程正忙:页面或者操作系统、浏览器正在忙别的任务,回调就得往后排。第三种情形是嵌套定时器:HTML 标准规定,setTimeout 嵌套调用超过 5 次之后,浏览器会强制最少等 4 毫秒。MDN 的实验是把 delay 0 的 setTimeout 一层一层往里嵌、前十次的间隔记下来:前四次的间隔大约是 0 毫秒,从第五次起大约是 4 毫秒。第四种情形是后台标签页:浏览器为了省电,会给不活动的标签页加最低延迟。MDN 列的数字是:Firefox 桌面版给不活动的标签页最少 1 秒,Firefox 安卓版最少 15 分钟、甚至可能把整个标签页卸载掉;Chrome 分三档,页面可见或者最近发过声音时几乎不节流,页面不可见不到 5 分钟时每秒才检查一次定时器,页面不可见超过 5 分钟、静音超过 30 秒、嵌套 5 次以上时进入密集节流,每分钟才检查一次。第五种情形是页面正在加载:Firefox 会把 setTimeout 的触发推迟到主线程空闲或者 load 事件触发。咖啡馆的例子:取餐屏那台电脑如果切到别的标签页、半小时没人看,30 秒刷新的间隔在 Chrome 里可能变成一分钟才检查一次,号码晚到是正常的,不是代码坏了。

第六步:clearTimeout,约好了也能取消

约好的事能取消,靠的就是第二步说的那个 ID。把 setTimeout 的返回值存下来,在它触发之前调 clearTimeout(那个ID),这次回调就不会跑了。第三步的按钮例子就是这个用法:点“Show”约了两秒后显示一句话,点“Cancel”就把它取消掉。用法上只有两条要注意。第一,ID 要存在一个够得着的地方,别写在函数里就丢了,第三步的例子把它存在外面的 let timeoutID 里,就是这个原因。第二,clearTimeout 和 clearInterval 在技术上可以互换,因为 setTimeout 和 setInterval 共用同一个 ID 池子,MDN 的原话是:注意 setInterval() 和 setTimeout() 共用同一个 ID 池子,clearInterval() 和 clearTimeout() 在技术上可以互换使用。但 MDN 紧接着说:为了清楚起见,还是应该配对使用,别给以后读代码的人留谜语。我的判断是:约一次的就用 clearTimeout 取消,每隔一阵的就用 clearInterval 取消,配对写,省得三个月后自己回来读代码都得猜。

第七步:setInterval,每隔一阵跑一次,第一次也要等

setInterval 的写法和 setTimeout 一模一样,只是意思变了:setInterval(func, delay) 是每隔 delay 毫秒跑一次 func,而且第一次执行也要等一个 delay,不是立刻跑。MDN 的原话是:第一次执行发生在 delay 毫秒之后。返回值同样是一个 ID,叫 interval ID,传给 clearInterval() 就能让它停下来。MDN 的例子是一个会闪烁的方块:

let intervalId;

function changeColor() {
  // check if an interval has already been set up
  intervalId ??= setInterval(flashText, 1000);
}

function flashText() {
  const oElem = document.getElementById("my_box");
  oElem.className = oElem.className === "go" ? "stop" : "go";
}

function stopTextColor() {
  clearInterval(intervalId);
  // release our intervalId from the variable
  intervalId = null;
}

document.getElementById("start").addEventListener("click", changeColor);
document.getElementById("stop").addEventListener("click", stopTextColor);

点“Start”,每秒闪一次,文字在绿和红之间切换;点“Stop”,停住。这里有个细节值得学:intervalId ??= setInterval(flashText, 1000) 的意思是“如果还没约过才约”,点十次“Start”也不会约出十个定时器一起闪。咖啡馆的例子:取餐屏刷新就是 const boardTimer = setInterval(refreshBoard, 30 * 1000),打烊时 clearInterval(boardTimer) 停掉。还有一条和 setTimeout 一样的规矩:嵌套超过 5 层之后,浏览器会把间隔最少钉在 4 毫秒,写得比 4 毫秒小也没用。

第八步:回调跑得比间隔慢,setInterval 会排队,要用递归 setTimeout

setInterval 最容易踩的坑,是回调本身跑得比间隔还慢。MDN 的原话是:如果你的逻辑有可能比间隔时间跑得还久,建议用 setTimeout 递归调用一个有名函数。MDN 举的例子是每 5 秒轮询一次远程服务器:网络延迟、服务器没反应,一大堆原因都可能让一次请求在 5 秒里跑不完,结果就是新的请求一个接一个排上去,排队的请求还不一定按顺序回来。MDN 推荐的写法是递归 setTimeout:

(function loop() {
  setTimeout(() => {
    // Your logic here
    loop();
  }, delay);
})();

这个写法的意思是:每次跑完自己的逻辑,才约下一次。MDN 的原话是:这个模式不能保证固定间隔执行,但能保证前一个间隔跑完之后才递归调用。换句话说,递归 setTimeout 保证的是“不重叠”,不是“准时”。我的判断是:取餐屏刷新这种“每次都要等网络回来”的活,别用 setInterval,用递归 setTimeout,刷新一次、等回来了、再约下一次,号码晚到一会儿没关系,排队排乱了才麻烦。反过来,如果回调每次都很快、比如只是切换一个颜色、加一个数字,setInterval 就够了,不用多写一层递归。

第九步:把方法直接传给定时器,this 会丢

传给 setTimeout、setInterval 的函数,是按普通函数调用的语义来定 this 的。MDN 的原话是:对于非箭头函数,this 会被设成 globalThis,也就是浏览器里的 window。MDN 的例子是一个计数器:

class Counter {
  constructor() {
    this.data = new Map();
  }

  count(item) {
    this.data.set(item, (this.data.get(item) || 0) + 1);
  }
}

const counter = new Counter();
counter.count("foo"); // Successfully adds "foo" to the map
setTimeout(counter.count, 1000, "bar");
// TypeError: Cannot read properties of undefined (reading 'set')

直接调 counter.count("foo") 没问题,因为 this 就是 counter;但把 counter.count 直接传给 setTimeout,一秒后跑起来的时候 this 已经不是 counter 了,this.data 是 undefined,再调 .set 就报 TypeError。MDN 给了三种修法。第一种,包一层匿名函数,里面显式用正确的对象调:setTimeout(() => counter.count("bar"), 1000),或者写成 setTimeout(function () { counter.count("bar"); }, 1000)。第二种,用箭头函数,因为箭头函数继承外层作用域的 this:setTimeout(() => { this.data.set(item, (this.data.get(item) || 0) + 1); }, 1000),写在方法里时 this 就是那个方法所属的对象。第三种,用 bind 绑死:setTimeout(counter.count.bind(counter), 1000, "bar")。MDN 在 setInterval 那篇里给了完全相同的例子和三种修法,因为两边的 this 规则是一样的。我的判断是:新手先记住第一种,包一层箭头函数,什么时候都管用;等写顺手了,再按 MDN 的三种修法挑顺手的。咖啡馆的例子:取餐屏对象有个 board.refresh() 方法,别写 setInterval(board.refresh, 30 * 1000),要写 setInterval(() => board.refresh(), 30 * 1000),不然一到刷新的时候就报 TypeError,号码停在原地不动。

第十步:第一个参数别传字符串,那是 eval 的亲戚

setTimeout 和 setInterval 的第一个参数除了传函数,还能传字符串,传了字符串就会被当成代码编译执行。MDN 的原话是:这种写法非常不推荐,理由和用 eval() 是一样的安全风险。MDN 的例子是:

const untrustedCode = "alert('Potentially evil code!');";
const id = setTimeout(untrustedCode, 1000);

如果这段字符串是用户提供的,那就成了一个跨站脚本攻击的口子。MDN 还写了,指定了 script-src 或者 default-src 的内容安全策略默认会拦住这种写法;如果非要放行,得用 TrustedScript 对象、加上 require-trusted-types-for 指令、再在 script-src 里写 trusted-types-eval,而且 MDN 强调这和 unsafe-eval 一样不安全,只不过它只在启用了可信类型时才放行。我的判断是:这条没有例外,第一个参数永远传函数。写 setTimeout("refreshBoard()", 1000) 和写 eval 是一个意思,代码评审看到这种写法可以直接打回去。真要动态拼代码,先想想是不是非拼不可,十有八九换成函数就能解决。

第十一步:什么时候用哪个,一张检查清单

最后把选型说清楚。只做一次的,用 setTimeout:下单后三秒闪一下“已接单”,就是它。每隔一阵做一次、每次都很快的,用 setInterval:取餐屏每三十秒刷新一次号码,就是它。每次要等网络或者等上一次跑完的,用递归 setTimeout:刷新一次、等回来了、再约下一次,就是它。做动画的,别用这两个,用 requestAnimationFrame,MDN 在两篇文档的“参见”里都把它列在第一位,因为它是跟着屏幕刷新走的,定时器不是。还有两件定时器管不着的事。第一,页面关了、标签页关了,定时器就没了,服务端那种“每天凌晨三点跑一次”的活是 cron 的,做法见站里的定时任务指南,别拿 setInterval 去顶。第二,防抖和节流都建立在 setTimeout 之上:防抖是“等用户停下来再做一次”,节流是“隔一阵做一次”,具体写法见站里的搜索框防抖指南,这篇只讲定时器本身,不重教一遍。检查清单照着过一遍:setTimeout 还是 setInterval,选对了没有;ID 存下来了没有,页面不用的时候 clearTimeout、clearInterval 有没有调;delay 是数字不是字符串,有没有超过 2147483647;回调里有没有直接传方法、this 会不会丢;setInterval 的回调跑得完跑不完,跑不完有没有换成递归 setTimeout;第一个参数是不是函数,不是字符串。

一个月 100 次定时器翻车,原因分布条形图

上图是虚构的青石咖啡馆点单页一个月里 100 次定时器翻车的原因分布:setInterval 忘了 clearInterval,关了页面还在跑、或者点了多次约出好几个 24 次;以为 setTimeout(..., 0) 会立刻执行 18 次;以为 delay 是精确时间,后台标签页切走了、主线程正忙就晚了 16 次;回调跑得比间隔慢,请求排队堆起来了 12 次;把方法直接传给 setTimeout,this 丢了报 TypeError 11 次;第一个参数传了字符串 10 次;delay 传了字符串或者超大值,以为会等很久 9 次。24 + 18 + 16 + 12 + 11 + 10 + 9 = 100,账是平的。排前三位的错加起来占了快六成,都是“把定时器当成准时、立刻、不用管的东西”的误会:定时器只保证“最少等这么久”,不保证准时、不保证立刻、约了不管还会一直跑。图里每一类都能在正文里找到对应的步骤:第一类见第七步和第六步,第二类见第五步,第三类见第五步,第四类见第八步,第五类见第九步,第六类见第十步,第七类见第四步。下次定时器行为不对,先按这个顺序查:先看 ID 有没有存、清没清,再看 delay 是不是数字、是不是 0,再看回调是不是跑得比间隔慢,大概率三步就能定位到。

回头看这篇的四件事:setTimeout 约一次,调完立刻返回,回调排到下一轮;setInterval 每隔一阵跑一次,第一次也要等一个 delay,停下来要调 clearInterval;delay 只保证“最少等这么久”,0 也不立刻、后台标签页还会更晚、超过 2147483647 会溢出;传参用第三个参数、this 丢了包一层箭头函数、第一个参数永远传函数。事件循环指南讲的是“任务怎么排队”,这篇讲的是“怎么约时间”,两件事合起来,才是浏览器里时间的完整样子。写完这篇就去把点单页的两个定时器按检查清单过一遍:下单提示用 setTimeout 约一次,取餐屏刷新换成递归 setTimeout,ID 存好,打烊时清掉,号码就不会再乱了。

阅读 2评论 0

评论 (0)

ME
0/1000
评论加载中...

原始来源

浏览项目广场发布你的项目

相关文章

真实照片:咖啡馆吧台后两位咖啡师并肩工作,一位正往白瓷杯里倒热牛奶拉花,另一位在操作意式咖啡机
指南
别让主线程一个人扛:Web Workers,把重活交给另一条线程

主线程又要画页面又要算账,一算就卡。Worker 是另一条线程、另一个全局上下文,两边只靠消息传话。本文按 MDN 的《Using Web Workers》与《Worker》两篇官方文档讲清楚:new Worker、postMessage 与 onmessage、结构化克隆的复制语义、Worker 里能与不能、onerror 与 terminate()、SharedWorker、Transferable 零拷贝,另附虚构咖啡馆点单页一个月 100 次 Worker 翻车的分布。

工具技巧前端工程学习与成长
真实照片:一位穿深色围裙的咖啡师正把奶缸里的热牛奶倒进白色咖啡杯,咖啡表面正在形成一颗爱心拉花图案,身后是一台意式咖啡机
指南
别一次全算完:JavaScript 生成器与迭代器 function*、yield,一次只给一个值

数组得一次全算好,生成器一次只给一个值,要的时候再算。本文按 MDN 的《Iterators and generators》《function*》《Generator》三篇官方文档讲清楚:next() 协议、function* 与 yield、for...of 消费、Symbol.iterator、yield* 委托、next(x) 往里传值、throw() 与 return(),以及什么时候该用生成器,另附虚构咖啡馆点单页一个月 100 次生成器翻车的分布。

工具技巧前端工程学习与成长
真实照片:砖墙上挂着一块手写粉笔咖啡菜单,写着 Espresso 2.95、Americano 2.95、Flat White 3.25、Cappuccino 3.50、Mocha 4.25、Latte 4.25,旁边有公平贸易与有机标志
指南
别再让缺失的数据把页面炸掉:JavaScript 可选链 ?. 与空值合并 ?? 实战指南

数据里缺一层,整张点单页就可能白屏。本文按 MDN 的《Optional chaining》《Nullish coalescing》《Logical nullish assignment》三篇官方文档讲清楚:?. 三种写法与短路、可选调用与方括号取值、?? 与 || 在 0 和空字符串上的差别、?. 与 ?? 联手、?? 不能和 ||、&& 直接混写、??= 补默认值,另附虚构咖啡馆点单页一个月 100 次取不到值的分布。

工具技巧前端工程学习与成长