# Webapi:setTimeout是怎么实现的

30 秒速记

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

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

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

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

function showName(){
  console.log(" 极客时间 ")
}
var timerID = setTimeout(showName,200);
@前端进阶之旅: 代码已经复制到剪贴板

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

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

面试官追问

追问 1产品要求点击后第 200ms 准时发埋点,setTimeout(send, 200) 能保证吗?
参考回答

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

追问 2浮层关了,5s 后的推荐回调还在更新已经卸载的组件,怎么改?
参考回答

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

追问 3页面切到后台,500ms 的定时器变成一秒才走一次,能把延迟调小来补偿吗?
参考回答

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

追问 4定时器注册了一直不执行,怎么确认是不是 setTimeout 坏了?
参考回答

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

# 浏览器怎么实现 setTimeout

30 秒速记

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

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

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

  • 当接收到 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);
@前端进阶之旅: 代码已经复制到剪贴板

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

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

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)
@前端进阶之旅: 代码已经复制到剪贴板