# Webapi：setTimeout是怎么实现的|浏览器篇

> 本文详细解析了浏览器中setTimeout的实现原理，结合事件循环、消息队列和延迟队列等机制，帮助前端开发者深入理解定时器的工作流程及其在JavaScript中的应用场景。

- 原文：https://feinterview.poetries.top/docs/fe-base-docs/browser/part4/16-Webapi%EF%BC%9AsetTimeout%E6%98%AF%E6%80%8E%E4%B9%88%E5%AE%9E%E7%8E%B0%E7%9A%84
- 来源：前端进阶之旅（feinterview.poetries.top）
- 更新：2026.10.03
- 可见范围：免费部分

---

## Webapi：setTimeout是怎么实现的

- `setTimeout(fn, ms)` 是浏览器给的 `Web API`，不是 `JS` 语言本身的功能
- 返回一个定时器 `ID`，回调执行前可以 `clearTimeout(id)` 取消
- `ms` 是「最少等多久」，不是「几点准时执行」，主线程忙、排队、后台节流都会让它更晚
- 适合防抖、超时兜底、延后清理；不适合精确计时和逐帧动画

**`setTimeout` 是浏览器提供的定时器，意思是「至少过这么久之后，再把回调排进去执行」。** 关键是「至少」两个字：时间到了只代表回调有资格执行，主线程还在跑别的就得接着等。它会返回一个数字 `ID`，组件卸载、条件失效时拿这个 `ID` 调 `clearTimeout` 取消。我一般把它用在防抖、请求超时兜底这种差个几十毫秒也无所谓的地方；倒计时、动画这种对时间敏感的，要用真实时间差去算，别靠回调次数累加。

那在接下来的两篇文章中，我会通过setTimeout和XMLHttpRequest这两个 WebAPI 来介绍事件循环的应用。这两个 WebAPI 是两种不同类型的应用，比较典型，并且在 JavaScript 中的使用频率非常高。你可能觉得它们太简单、太基础，但有时候恰恰是基础简单的东西才最重要，了解它们是如何工作的会有助于你写出更加高效的前端代码。

本篇文章主要介绍的是setTimeout。其实说起 setTimeout 方法，从事开发的同学想必都不会陌生，它就是一个定时器，用来指定某个函数在多少毫秒之后执行。它会返回一个整数，表示定时器的编号，同时你还可以通过该编号来取消这个定时器。下面的示例代码就演示了定时器最基础的使用方式：

```js
function showName(){
  console.log(" 极客时间 ")
}
var timerID = setTimeout(showName,200);
```

执行上述代码，输出的结果也很明显，通过 setTimeout 指定在 200 毫秒之后调用 showName 函数，并输出“极客时间”四个字。

简单了解了 setTimeout 的使用方法后，那接下来我们就来看看浏览器是如何实现定时器的，然后再介绍下定时器在使用过程中的一些注意事项

- **产品要求点击后第 `200ms` 准时发埋点，`setTimeout(send, 200)` 能保证吗？**

  保证不了，它只保证不早于 `200ms`。主线程要是正在跑一个 `300ms` 的任务，实际就是 `300ms` 以后。真需要「点击就发」直接同步调 `navigator.sendBeacon`，别绕定时器。

- **浮层关了，`5s` 后的推荐回调还在更新已经卸载的组件，怎么改？**

  注册时把 `ID` 存下来，卸载时 `clearTimeout(id)`。`React` 里就是 `useEffect` 返回的清理函数里清掉；回调里最好再判断一下状态，防止取消前回调已经开始跑。

- **页面切到后台，`500ms` 的定时器变成一秒才走一次，能把延迟调小来补偿吗？**

  没用，后台标签页的定时器会被浏览器节流到最多每秒一次，`Chrome 88+` 隐藏超过 `5` 分钟的页面链式定时器还可能被压到每分钟一次。业务要看真实时间就用 `Date.now()` 重新算，别数回调次数。

- **定时器注册了一直不执行，怎么确认是不是 `setTimeout` 坏了？**

  用 `performance.now()` 打下注册时间和回调时间，再去 `Performance` 面板看那段时间主线程在干什么。九成是有长任务占着，或者页面在后台被节流了，`API` 本身基本不会坏。

## 浏览器怎么实现 setTimeout

- 定时回调不能直接塞进普通消息队列，因为队列只管顺序不管时间
- `Chrome` 另有一个延迟队列：调 `setTimeout` 时记下回调、发起时间、延迟、`ID` 放进去
- 事件循环每执行完一个任务，就检查延迟队列，把到期的拿出来执行
- 到期只是有资格执行，不会抢占正在跑的代码；`clearTimeout` 就是按 `ID` 从延迟队列里删掉
- 没有「一个定时器一个线程」这回事，计时和回调都在渲染进程里统一管

**浏览器实现 `setTimeout` 的思路是：普通任务一个队列，延迟任务另一个队列，事件循环每转一圈都去看看延迟队列里有没有到期的。** 调用 `setTimeout(showName, 200)` 时，渲染进程会创建一个延迟任务，记下回调、当前时间、`200`、定时器 `ID`，放进延迟队列。主线程每处理完一个普通任务，就按当前时间算一下哪些到期了，依次执行。所以回调永远不会插到正在执行的代码中间，前面任务越久它越晚。`clearTimeout(id)` 也很直白，按 `ID` 把还没执行的任务从队列里删掉。

```mermaid
sequenceDiagram
    autonumber
    participant J as JS代码
    participant R as 渲染进程
    participant D as 延迟队列
    participant L as 事件循环
    J->>R: 调用 setTimeout(fn, 200)
    R->>D: 存入回调、发起时间、延迟、ID
    R-->>J: 返回定时器 ID
    L->>L: 执行当前普通任务
    L->>D: 任务结束后检查到期任务
    alt 已调用 clearTimeout(id)
        D-->>L: 任务已删除，什么都不做
    else 时间已到
        D-->>L: 取出到期回调
        L->>J: 在主线程执行 fn
    else 还没到期
        D-->>L: 继续等下一轮
    end
```

要了解定时器的工作原理，就得先来回顾下之前讲的事件循环系统，我们知道渲染进程中所有运行在主线程上的任务都需要先添加到消息队列，然后事件循环系统再按照顺序执行消息队列中的任务。下面我们来看看那些典型的事件

- 当接收到 HTML 文档数据，渲染引擎就会将“解析 DOM”事件添加到消息队列中，
- 当用户改变了 Web 页面的窗口大小，渲染引擎就会将“重新布局”的事件添加到消息队列中。
- 当触发了 JavaScript 引擎垃圾回收机制，渲染引擎会将“垃圾回收”任务添加到消息队列中。
- 同样，如果要执行一段异步 JavaScript 代码，也是需要将执行任务添加到消息队列中

以上列举的只是一小部分事件，这些事件被添加到消息队列之后，事件循环系统就会按照消息队列中的顺序来执行事件。

所以说要执行一段异步任务，需要先将任务添加到消息队列中。不过通过定时器设置回调函数有点特别，它们需要在指定的时间间隔内被调用，但消息队列中的任务是按照顺序执行的，所以为了保证回调函数能在指定时间内执行，你不能将定时器的回调函数直接添加到消息队列中。

那么该怎么设计才能让定时器设置的回调事件在规定时间内被执行呢？你也可以思考下，如果让你在消息循环系统的基础之上加上定时器的功能，你会如何设计？

在 Chrome 中除了正常使用的消息队列之外，还有另外一个消息队列，这个队列中维护了需要延迟执行的任务列表，包括了定时器和 Chromium 内部一些需要延迟执行的任务。所以当通过 JavaScript 创建一个定时器时，渲染进程会将该定时器的回调任务添加到延迟队列中

源码中延迟执行队列的定义如下所示：

```
DelayedIncomingQueue delayed_incoming_queue;
```

当通过 JavaScript 调用 setTimeout 设置回调函数的时候，渲染进程将会创建一个回调任务，包含了回调函数 showName、当前发起时间、延迟执行时间，其模拟代码如下所示：

```
struct DelayTask{
  int64 id；
  CallBackFunction cbf;
  int start_time;
  int delay_time;
};
DelayTask timerTask;
timerTask.cbf = showName;
timerTask.start_time = getCurrentTime(); // 获取当前时间
timerTask.delay_time = 200;// 设置延迟执行时间
```

创建好回调任务之后，再将该任务添加到延迟执行队列中，代码如下所示：

```
delayed_incoming_queue.push(timerTask)；
```

现在通过定时器发起的任务就被保存到延迟队列中了，那接下来我们再来看看消息循环系统是怎么触发延迟队列的。

我们可以来完善上一篇文章中消息循环的代码，在其中加入执行延迟队列的代码，如下所示

```c
void ProcessTimerTask(){
  // 从 delayed_incoming_queue 中取出已经到期的定时器任务
  // 依次执行这些任务
}

TaskQueue task_queue；
void ProcessTask();
bool keep_running = true;
void MainTherad(){
  for(;;){
    // 执行消息队列中的任务
    Task task = task_queue.takeTask();
    ProcessTask(task);

    // 执行延迟队列中的任务
    ProcessDelayTask()

    if(!keep_running) // 如果设置了退出标志，那么直接退出线程循环
        break;
  }
}
```

从上面代码可以看出来，我们添加了一个ProcessDelayTask 函数，该函数是专门用来处理延迟执行任务的。这里我们要重点关注它的执行时机，在上段代码中，处理完消息队列中的一个任务之后，就开始执行 ProcessDelayTask 函数。ProcessDelayTask 函数会根据发起时间和延迟时间计算出到期的任务，然后依次执行这些到期的任务。等到期的任务执行完成之后，再继续下一个循环过程。通过这样的方式，一个完整的定时器就实现了。

设置一个定时器，JavaScript 引擎会返回一个定时器的 ID。那通常情况下，当一个定时器的任务还没有被执行的时候，也是可以取消的，具体方法是调用clearTimeout 函数，并传入需要取消的定时器的 ID。如下面代码所示：

```
clearTimeout(timer_id)
```

其实浏览器内部实现取消定时器的操作也是非常简单的，就是直接从 delayed_incoming_queue 延迟队列中，通过 ID 查找到对应的任务，然后再将其从队列中删除掉就可以了。

- **`setTimeout(report, 0)` 后面跟着 `300ms` 的同步计算，`report` 会打断计算吗？**

  不会。`0` 只是说不额外等，但它得等当前任务整个跑完。实际执行至少在 `300ms` 以后：

  `setTimeout(() => console.log('B'), 0); heavyWork(); console.log('A') // 输出 A 再 B`

- **有人说每调一次 `setTimeout`，浏览器就开一个线程去睡眠计时，对吗？**

  不对。定时器都放在渲染进程的延迟队列里统一管理，到期的回调还是回到主线程执行。要是真一个定时器一个线程，页面里几千个定时器早崩了。

- **弹窗同时有 `30s` 自动关闭和 `5s` 刷新，取消自动关闭时用一个布尔变量控制，行吗？**

  能凑合，但定时器还挂着，到点照样会执行一次回调。正确做法是两个 `ID` 分开存，取消哪个就 `clearTimeout` 哪个。

- **调了 `clearTimeout(timerId)`，还是看到一次旧请求发出去了，可能是什么原因？**

  两种可能：要么取消时回调已经开始执行了，`clearTimeout` 撤不回正在跑的代码；要么 `timerId` 被覆盖了，比如重复注册时只记了最后一个 `ID`，前面那个没清掉。

## 使用 setTimeout 的一些注意事项

- 当前任务跑多久，到期回调就多等多久，`setTimeout(fn, 0)` 也绕不开同步代码
- 嵌套超过 `5` 层且延迟小于 `4ms` 时，浏览器强制最少 `4ms`（`HTML` 规范写死的）
- 后台标签页定时器最多每秒一次；`Chrome 88+` 隐藏久了的页面链式定时器还会压到每分钟一次
- 延迟用 `32` 位有符号整数存，超过 `2147483647ms`（约 `24.8` 天）会溢出，立刻执行
- 把 `obj.method` 直接传进去会丢 `this`，用箭头函数包一层或 `bind`

**`setTimeout` 的坑基本都和「它不准」有关，再加一个 `this` 丢失。** 第一，同步代码没跑完，到期回调只能等，写 `0` 也一样。第二，嵌套调用超过 `5` 层，浏览器会把小于 `4ms` 的间隔拉到 `4ms`，所以递归 `setTimeout(fn, 0)` 跑不出想象中的速度。第三，页面在后台时会被节流到每秒最多一次。第四，延迟值超过约 `24.8` 天会溢出，等于立刻执行。最后，`setTimeout(obj.say, 100)` 里的 `this` 不再是 `obj`，我习惯写成 `setTimeout(() => obj.say(), 100)`。

现在你应该知道在浏览器内部定时器是如何工作的了。不过在使用定时器的过程中，如果你不了解定时器的一些细节，那么很有可能掉进定时器的一些陷阱里。所以接下来，我们就来讲解一下在使用定时器过程中存在的那些陷阱。

**1. 如果当前任务执行时间过久，会影延迟到期定时器任务的执行**

在使用 setTimeout 的时候，有很多因素会导致回调函数执行比设定的预期值要久，其中一个就是当前任务执行时间过久从而导致定时器设置的任务被延后执行。我们先看下面这段代码：

```js
function bar() {
    console.log('bar')
}
function foo() {
    setTimeout(bar, 0);
    for (let i = 0; i < 5000; i++) {
        let i = 5+8+8+8
        console.log(i)
    }
}
foo()
```

这段代码中，在执行 foo 函数的时候使用 setTimeout 设置了一个 0 延时的回调任务，设置好回调任务后，foo 函数会继续执行 5000 次 for 循环。

通过 setTimeout 设置的回调任务被放入了消息队列中并且等待下一次执行，这里并不是立即执行的；要执行消息队列中的下个任务，需要等待当前的任务执行完成，由于当前这段代码要执行 5000 次的 for 循环，所以当前这个任务的执行时间会比较久一点。这势必会影响到下个任务的执行时间。

你也可以打开 Performance 来看看其执行过程，如下图所示：

![](https://s.poetries.top/gitee/2019/11/33.png)

从图中可以看到，执行 foo 函数所消耗的时长是 500 毫秒，这也就意味着通过 setTimeout 设置的任务会被推迟到 500 毫秒以后再去执行，而设置 setTimeout 的回调延迟时间是 0。

**2. 如果 setTimeout 存在嵌套调用，那么系统会设置最短时间间隔为 4 毫秒**

也就是说在定时器函数里面嵌套调用定时器，也会延长定时器的执行时间，可以先看下面的这段代码：

```js
function cb() { setTimeout(cb, 0); }
setTimeout(cb, 0);
```

上述这段代码你有没有看出存在什么问题？

你还是可以通过 Performance 来记录下这段代码的执行过程，如下图所示

![](https://s.poetries.top/gitee/2019/11/34.png)

---

> 以上是免费部分。完整内容需要「前端进阶之旅」会员，原文：https://feinterview.poetries.top/docs/fe-base-docs/browser/part4/16-Webapi%EF%BC%9AsetTimeout%E6%98%AF%E6%80%8E%E4%B9%88%E5%AE%9E%E7%8E%B0%E7%9A%84
