一句话回答
回调是传给另一段代码的函数,让对方在事件发生或任务完成后再来调用它。它是事件处理和异步代码的基本构件,SDK 的错误和同意钩子也用它。
回调是什么
回调(callback)是你交给另一段代码的一个函数,让对方在某件事发生之后再来调用它。MDN 把回调函数定义为作为参数传给另一个函数、并由后者调用来完成某种动作的函数(MDN)。名字就说明了一切:你交出一个函数,对方准备好了就「回头调用」。
function greet(name, done) {
console.log('Hello, ' + name);
done(); // 回调
}
greet('Ada', function () { console.log('finished'); });
你交出的是什么时候运行这个函数的控制权。这一点解释了人们遇到回调时大部分的意外,本页其余部分讲的就是这些意外。
在编程之外,「callback」还有别的意思:给某人回的第二个电话、试镜的第二轮、呼应前面某个笑话的包袱。本页讲的是编程里的含义。
同步回调和异步回调
MDN 按运行时机区分回调:同步(立即,在调用之内)或异步(之后,在当前代码结束之后)。分析副作用时,时机很关键。
| 类型 | 什么时候运行 | JavaScript 里的例子 |
|---|---|---|
| 同步 | 在调用它的函数返回之前 | Array.prototype.map()、forEach()、sort() 的比较函数 |
| 异步 | 当前代码结束之后,事件或定时器触发时 | setTimeout()、事件监听、网络请求、Promise.then() |
用一小段代码检验两者的区别,输出按顺序:
console.log('A');
setTimeout(function () { console.log('B'); }, 0);
[1].forEach(function () { console.log('C'); });
console.log('D');
// A, C, D, B
forEach 立即运行它的回调,所以 C 排在 D 之前。定时器回调要等当前代码跑完,所以即使延迟为零,B 也排在最后。
回调用在哪些地方
- 事件处理。「点击这个按钮时,运行这个函数」,这个处理函数就是回调。
- 异步工作。 读文件、网络请求或定时器,在结果就绪时调用你的函数。
- 定制通用函数。 用你自己的比较方式排序,或用你自己的条件过滤。
- 库向你汇报。 SDK 在成功、失败或状态变化时调用你的函数。
同样的形式在许多语言里都有:C 传函数指针,Python 传函数,Java 传接口对象或 lambda。
要清楚对方到底传哪些参数。参数由调用方提供,回调只收到被发过来的东西。array.map(function (item, index, array) { ... }) 按顺序传入元素、它的位置和整个数组;如果回调期望的顺序不同,就会悄悄地出错。读一读你要把函数交给的那个函数的文档;如果你是调用方,就在注释里写明顺序。
能避免大部分 bug 的约定
- 错误优先。 许多接口按
callback(error, result)调用:先检查error,没有错误才用result。这样不可能忘了处理失败。 - 只调用一次。 一个可能触发两次的回调(成功一次、之后失败又一次)会带来重复工作。
- 要么总是同步,要么总是异步。 一个函数有时立即回调、有时稍后回调,很难推理;选一种。
- 保留你自己的上下文。 回调可能在不同的
this下运行,或在变量变化之后运行;把你需要的值先保存下来。 - 明确处理失败。 回调内部未处理的错误,往往没地方去。
算例:串行回调和并行工作
示例数据:一个页面需要用户(120 毫秒)、他的订单(200 毫秒)和他的推荐(150 毫秒)。三者都不需要别人的结果。
| 写法 | 怎么运行 | 总耗时 |
|---|---|---|
| 嵌套回调,一个接一个 | 先用户,再订单,再推荐 | 120 + 200 + 150 = 470 毫秒 |
| 三个同时发起 | 等最慢的那个 | max(120, 200, 150) = 200 毫秒 |
复算:120 + 200 + 150 = 470,三者中最慢的是 200。因为这些请求互不依赖,嵌套白白让页面慢了 270 毫秒。
嵌套还会造成「厄运金字塔」:每一步都深一层,每一层都要重复错误处理。MDN 的 Promise 指南就把这个金字塔作为引入 Promise 的动机,Promise 把链条拉平,错误只在一个地方捕获(MDN:Using promises)。判断规则:步骤互相依赖,就串起来;不依赖,就同时发起。
回调、Promise 和 async/await
| 方式 | 优点 | 缺点 |
|---|---|---|
| 回调 | 简单,到处能用,不需要额外概念 | 嵌套;错误处理分散 |
| Promise | 链条平,一个 catch | 要学一个新对象;容易忘记 return |
async / await | 读起来像普通代码 | 底层还是 Promise;默认是串行的 |
Promise 并没有取消回调,.then() 本身就接收一个回调。它们改变的是谁掌握控制流。在事件处理、旧的库和 SDK 选项里,你仍然会遇到回调。
常见误区
- 以为回调已经运行了。 异步调用之后的代码会先运行。需要结果,就在回调里用。
- 调用函数而不是传函数。
setTimeout(go(), 100)现在就运行go,传进去的是它的返回值;你要的是setTimeout(go, 100)。 - 丢失错误。 异步回调里抛出的失败,到不了启动它的那段代码。
- 页面退出时还指望能做等不及的事。 网络请求之后的回调,如果页面先关了,可能永远不会运行。未捕获的错误怎么出现,参见 JavaScript 错误。
- 把「回调」和「Webhook」当成一回事。 Webhook 是跨网络的回调:你给的是一个网址,不是一个函数。
统计代码里的回调与 TapCub
回调在统计里出现在几个具体的地方。以下按 TapCub 文档里的行为来说:
- 单页应用的页面浏览。 如果你的路由不改变地址,就在路由器的「路由就绪」回调里调用
window.tapcub.pageview(),让页面数据准备好之后再发这次浏览。如果自动记录已开启、网址已经变了,就不要再调用,否则 2 秒窗口过后会出现第二行。 - 服务端和移动端 SDK 的错误。 服务端 SDK 有
onError选项(Python 里叫on_error),在批次被丢弃或被拒时调用;Android SDK 还提供onConsentChange、onSessionStart、onError和init(callback),在主线程运行。这个回调里出现send_failed这样的代码,说明 SDK 放弃了某个批次,参见文档里的 SDK 网络说明。 - 不要等统计。 网站脚本优先用
sendBeacon,其次是带keepalive的fetch,没有本地队列,所以页面关闭前没发出去的那一次就丢了。不要让页面跳转依赖统计回调。 - 在数据里验证结果。 接好路由就绪回调之后,到 网站统计 › 实时 或 网站统计 › 页面 确认每次路由变化只有一次浏览。
TapCub 不运行你的回调,也不修异步代码;它记录你的代码上报的内容。全端分析 › 数据管理 › 埋点方案 里计划好的事件名,可以通过实时验证的计数,看出回调有没有按预期触发。
资料来源
- MDN Web Docs,Callback function。
- MDN Web Docs,Using promises。
这个解释清楚吗?
我们会根据反馈修改和补充这篇内容。
提交没有成功,请稍后再试。
谢谢你的反馈,我们会据此改进这篇内容。你已经反馈过这篇了,谢谢。
