前端学习笔记 · 第 125 天:微任务与 EventEmitter——nextTick、setImmediate 与事件监听
- 2026-11-19 16:22:21
前端学习笔记 · 第 125 天:微任务与 EventEmitter——nextTick、setImmediate 与事件监听
Day 125 · 第五阶段 · Node.js 与后端开发
执行顺序是排查「偶发」问题的关键:同一段代码放在 .mjs 与 .cjs 里,输出顺序都可能不同。事件发射器则提供了另一种组织方式:注册监听、触发事件、移除监听,比层层回调更容易拆分。
一、三种队列与执行顺序
Node 的事件循环里,回调分属三个队列:
process.nextTick队列:当前操作结束后立刻执行,排在事件循环继续之前。 Promise 微任务队列: then、catch、finally的回调。宏任务队列:定时器、 setImmediate、I/O 回调。
经典结论是三者按「nextTick、Promise、宏任务」的顺序清空。同一段示例可以验证:
const baz = () => console.log("baz");const foo = () => console.log("foo");const zoo = () => console.log("zoo");const start = () => { console.log("start"); setImmediate(baz); new Promise((resolve) => { resolve("bar"); }).then((value) => { console.log(value); process.nextTick(zoo); }); process.nextTick(foo);};start();这段代码保存为 .cjs 时输出 start foo bar zoo baz:nextTick 的 foo 先于 Promise 的 bar。保存为 .mjs 时输出 start bar foo zoo baz:Promise 的回调反而先执行。
差异来自模块的加载方式。ESM 模块按异步方式加载,脚本执行时已经处在微任务队列里,因此立即兑现的 Promise 回调会先于 nextTick 排队。
嵌套排队时顺序同样会反转。在 .mjs 里,同步代码之后先打印 promise,再依次打印 tick1、tick2;在 .cjs 里则是 tick1、tick2 在前,promise 在后。
结论是:队列的优先级有章可循,但模块加载方式会改变起点。需要严格顺序时,把后一步放进前一步的回调里,而不是依赖两个队列的默认先后。
二、nextTick 与 setImmediate 的时机
process.nextTick 把回调排到当前操作之后、事件循环继续之前。在 CommonJS 里,它比 Promise 更早,也比任何定时器都早,适合「当前逻辑收尾后立刻处理」的场景。
process.nextTick(() => { console.log("当前操作结束后立刻执行");});setImmediate 把回调排到下一轮事件循环的检查阶段,适合把一段工作从当前轮次挪到下一轮,让出主线程。
setImmediate(() => { console.log("下一轮事件循环执行");});setTimeout(fn, 0) 与 setImmediate 都在下一轮执行,但分属不同阶段。实测主模块里连续五轮都是 immediate 先于 timeout;不过先后受执行环境影响,不应写进依赖顺序的代码。
在 I/O 回调里,顺序则稳定为 setImmediate 先:
import { readFile } from "node:fs";readFile("sample.txt", "utf8", () => { console.log("读取完成"); setTimeout(() => console.log("timeout"), 0); setImmediate(() => console.log("immediate"));});输出为「读取完成、immediate、timeout」。I/O 回调结束后进入检查阶段,setImmediate 的回调先轮到,定时器要等下一轮的定时器阶段。
nextTick 有一个需要避免的用法:递归调用自己。
function loop() { process.nextTick(loop); // 永远清不完,I/O 没有机会执行}loop();nextTick 队列必须全部清空才会继续,递归排队会让事件循环停在这里。需要分批推进时,用 setImmediate 把下一批放到下一轮。
三、EventEmitter 的注册与触发
EventEmitter 是 node:events 提供的类,负责事件的注册与触发。on 注册监听器,emit 触发事件,附加参数会原样传给每个监听器。
import EventEmitter from "node:events";const bus = new EventEmitter();const first = (value) => console.log("first", value);bus.on("ping", first);bus.on("ping", (value) => console.log("second", value));console.log(bus.listenerCount("ping")); // 2console.log(bus.emit("ping", 1)); // truebus.off("ping", first);emit 是同步调用:返回时全部监听器已经执行完,顺序与注册顺序一致。返回值表示该事件是否有监听器,有则为 true,没有则为 false。
once 注册的监听器只执行一次,触发后自动移除;off 按函数引用移除指定监听器;removeAllListeners 清空某个事件的全部监听器。
bus.once("ready", () => console.log("ready"));bus.emit("ready");bus.emit("ready"); // 第二次没有输出,监听器已移除error 事件是特殊事件。没有注册监听器时,emit("error", err) 会直接抛出错误,默认行为是打印堆栈并以退出码 1 结束进程。为事件发射器注册 error 监听器,是把它接入业务流程的必要一步。
同一个函数注册两次会被调用两次。排查「回调执行了两遍」时,先看 listenerCount,再检查注册代码是否在每次请求里都执行了一遍。单个事件默认超过 10 个监听器会打印警告,用于提示可能的泄漏。
四、实战示例:任务进度汇报
把注册、触发、一次性监听与计数放进一个脚本:两个任务依次执行,start 与 progress 正常汇报,done 用 once 只处理第一次完成。
// job-runner.mjs —— 用 EventEmitter 汇报任务进度import EventEmitter from "node:events";const jobs = new EventEmitter();jobs.on("start", (name) => console.log(`开始 ${name}`));jobs.on("progress", (name, percent) => console.log(`${name} 进度 ${percent}%`));jobs.once("done", (name) => console.log(`完成 ${name},监听器已移除`));jobs.on("error", (name, error) => console.log(`失败 ${name}:${error.message}`));async function run(name, steps) { jobs.emit("start", name); for (let i = 1; i <= steps; i++) { await new Promise((resolve) => setTimeout(resolve, 50)); jobs.emit("progress", name, Math.round((i / steps) * 100)); } jobs.emit("done", name);}await run("导出", 3);await run("上传", 2);console.log(`done 监听器数量 ${jobs.listenerCount("done")}`);运行结果:
$ node job-runner.mjs开始 导出导出 进度 33%导出 进度 67%导出 进度 100%完成 导出,监听器已移除开始 上传上传 进度 50%上传 进度 100%done 监听器数量 0第一个任务完成时,once 的监听器执行并自动移除;第二个任务完成时 done 已无监听器,只留下 listenerCount 为 0。progress 是普通监听器,两个任务各自触发三次与两次,全部正常输出。
error 监听器没有触发,但它的存在决定了异常时的行为:一旦某个任务失败并触发 error,进程会走这条分支,而不是直接退出。
常见问题
Q1:process.nextTick 与 Promise.then 谁先执行?
在 CommonJS 里 nextTick 先,Promise 微任务后。在 ESM 顶层,立即兑现的 Promise 回调可能先执行,因为模块本身按异步方式加载。依赖顺序时应把后一步写进前一步的回调,而不是依赖默认队列顺序。
Q2:setImmediate 与 setTimeout(fn, 0) 谁先?
两者都在下一轮事件循环执行,但阶段不同。主模块里的先后受执行环境影响,实测连续五轮都是 setImmediate 先,但不能作为保证;在 I/O 回调里 setImmediate 稳定先执行。
Q3:递归调用 process.nextTick 会怎样?
nextTick 队列必须清空才会继续事件循环,递归排队会让 I/O 与定时器得不到执行机会。需要分批推进时用 setImmediate,把下一批放到下一轮。
Q4:on 与 once 有什么区别?
on 注册的监听器每次触发都会执行;once 注册的监听器执行一次后自动移除。只关心首次事件的场景用 once,避免手动移除。
Q5:emit 是同步还是异步?
同步。emit 返回时所有监听器已经执行完毕,返回值是布尔值,表示该事件是否有监听器。监听器内部如果做异步操作,那些操作仍按各自的节奏完成。
Q6:error 事件为什么要单独处理?
没有监听器的 error 事件会直接抛出,默认让进程以退出码 1 结束。注册 error 监听器后,错误进入业务分支,可以记录、重试或降级处理。
知识点总结
三类队列:
回调分属
nextTick队列、Promise 微任务队列与宏任务队列CommonJS 顺序:
同步代码之后依次是
nextTick、Promise、宏任务ESM 差异:
模块按异步方式加载,顶层 Promise 回调可能先于
nextTicknextTick 用途:
当前操作收尾后立刻执行,递归调用会阻塞事件循环
setImmediate:
回调放在下一轮事件循环的检查阶段,适合让出主线程
定时器先后:
主模块里
setImmediate与setTimeout(0)的先后不稳定,I/O 回调里前者先事件触发:
触发时
emit同步调用监听器,顺序与注册顺序一致,返回是否有监听器监听器管理:
移除与计数用
once、off与listenerCount处理error 事件:
没有监听器时会抛出并以退出码 1 结束,必须显式注册
(本文为学习笔记整理)