初识 `tellmewhen`：它到底是个啥？
哎呀，每次跟后辈聊起前端开发，总有些概念让人头大，比如这个 tellmewhen。别看它名字挺玄乎，其实说白了就是浏览器提供的一个API，专门用来告诉你某个网络请求大概需要多久才能完成。简单点说，就是个预测工具，能帮你提前知道用户点击链接或按钮后，要等多久才能看到结果。这在设计用户体验（UX）时特别有用，比如你不会想让用户点个“加载中”按钮，结果等半天吧？它的核心作用就是优化等待感知，减少用户焦虑。
为啥我们需要 `tellmewhen`？
想象一下，你是个用户。你点了个按钮，页面开始转圈圈，然后又转了五分钟… 你会咋想？大概率是“这破网站不行，关了！”对吧？现代网页加载越来越慢，用户耐心有限。这时候，预测等待时间就显得尤为重要。`tellmewhen` 就能帮你干这活儿，它不是直接告诉你“要等3秒”，而是根据过去的请求表现，给出一个概率性的估计，比如“可能需要 2-4秒”。这样用户心里就有个底，知道这等待是正常的，不是系统卡死了。
`tellmewhen` 的基本用法：简单粗暴型
要使用 `tellmewhen`，其实挺简单的。基本流程就是：创建一个预测器，给它一个目标元素（用户要点击的那个玩意儿），然后告诉它当用户开始交互（比如点击）时要干啥。下面是个超简单的例子：
const predict = tellmewhen();
const button = document.querySelector('my-button');
predict.onStart(predict => {
predict.begin(button);
});
predict.onResults(predict => {
console.log(`预估等待时间：${predict.estimatedWaitTime}ms`);
});
这段代码干的事儿就是：当用户开始点击 my-button 这个按钮时，`tellmewhen` 就会启动预测，然后等预测结果出来后，在控制台打印出预估的等待时间（单位是毫秒）。是不是很简单？
进阶用法：自定义预测源
不过啊，默认的预测可能不够精准，因为 `tellmewhen` 默认只参考浏览器自己内部的请求数据。如果你想让预测更准，就得自己提供更靠谱的数据，这就是所谓的 自定义预测源。怎么干？得创建一个 PerformancePredictor 实例，给它喂数据，然后注册到 `tellmewhen` 里。下面是个更复杂的例子：
const predict = tellmewhen();
const button = document.querySelector('my-button');
// 创建自定义预测源
const myPredictor = new PerformancePredictor();
myPredictor.onPredict = (entries) => {
// 这里的entries是PerformanceEntry的数组，你可以根据这些历史请求数据来计算预估时间
// 比如根据请求大小、响应时间等
const estimatedTime = calculateMyEstimate(entries);
entries.forEach(entry => {
entry.estimatedWaitTime = estimatedTime;
});
};
// 注册自定义预测源
predict.addPredictor(myPredictor);
predict.onStart(predict => {
predict.begin(button);
});
predict.onResults(predict => {
console.log(`预估等待时间（自定义）：${predict.estimatedWaitTime}ms`);
});
这段代码展示了如何创建一个自定义的预测源。`calculateMyEstimate` 函数是你自己写的，根据历史请求数据（比如请求大小、响应时间）来计算预估等待时间。这样，`tellmewhen` 就会优先使用你提供的数据来做预测，通常结果会更准。
设置 `tellmewhen`：配置小技巧
`tellmewhen` 还提供了一些配置选项，可以让你根据需要调整它的行为。最常用的就是设置预测的置信度和时间范围。
-
置信度（Confidence）：值越接近1，预测越“敢肯定”，但可能不够灵敏；值越接近0，预测越保守，但更可能准确。默认值通常是0.8左右，你可以根据自己应用的特点调整。
-
时间范围（Time Range）：这个决定了用来做预测的历史数据的时间跨度。比如，你可以设置只看最近5秒内的请求数据。默认值通常是10秒。如果你知道某些操作总是很快完成，缩小时间范围可能更准。
设置这些选项很简单，创建 `tellmewhen` 实例时就能传参：
const predict = tellmewhen({
confidence: 0.9, // 设置更高的置信度
timeRange: 5000 // 设置历史数据时间范围为5秒
});
`tellmewhen` vs 其他加载指示器：啥时候用啥
有时候有人会问，`tellmewhen` 和普通的加载指示器（比如旋转的加载图标）有啥区别？简单说：
-
`tellmewhen`：告诉你“大概要等多久”，侧重于预测等待感知，适合有明确结束状态的操作（比如提交表单、加载页面）。
-
普通加载指示器：告诉你“我正在忙，别催”，侧重于告知处理状态，适合长时间未知处理的操作（比如上传大文件）。
如果你想让用户知道点击按钮后要等一会儿，但又不想让用户干等着干着急，`tellmewhen` 就是个好选择。如果操作时间太长且无法预估，普通加载指示器可能更合适。
优缺点分析
没啥东西是完美的，`tellmewhen` 也有它的坑：
| 方面 | 优点 | 缺点 |
|---|---|---|
| 用户体验 | 减少用户焦虑，提升等待感知 | 预测不准时可能更糟糕，增加认知负担 |
| 实现复杂度 | 基本用法简单 | 自定义预测源需要性能分析知识 |
| 兼容性 | Chrome, Firefox, Edge 等主流浏览器支持良好 | 较新的浏览器特性，旧设备可能不支持 |
实际案例：电商网站提交订单
举个栗子。你在某电商平台提交订单，点击“提交”按钮后，页面会显示一个预估等待时间的提示，比如“预计剩余3秒”。这就是 `tellmewhen` 在工作的一个场景。如果后台订单处理慢，这个提示能让你知道系统在忙，而不是以为按钮没点进去。如果预测不准，比如系统突然卡住，你可能还会觉得“奇怪，怎么预估的3秒过去了还没反应？”这其实也提醒了开发者要保证预测的准确性。
：用好 `tellmewhen`，让等待不再难熬
`tellmewhen` 是个挺酷的浏览器API，能帮你解决用户等待时的焦虑问题。它不是万能的，但用对了地方，效果显著。关键在于：理解它的原理，合理配置，并在需要时提供准确的预测数据。别把它当成万能，也别完全不用，根据你的应用场景来决定。多试试，你会发现它在提升用户体验方面是个挺不错的选择。