构建可靠异步控制核心库的关键是嵌入可控性与可退守性:通过abortsignal.timeout精准断点并双重确认aborted状态实施多级降级(网络→缓存→默认值),兼容旧环境独立路径,全链路注入可观测日志。

构建真正可靠的异步控制核心库,关键不是堆功能,而是把“可控性”和“可退守性”嵌入每层逻辑。它不追求所有请求都更快,而确保在超时、网络中断、服务不可用或浏览器不支持等任何异常下,都能返回确定、安全、可追踪的结果。
用 AbortSignal.timeout 做精准断点,不替代降级
AbortSignal.timeout 是目前最轻量、标准的超时信号源,但它只负责发出中断信号,不做兜底。
- 必须通过 err.name === 'AbortError' 明确判断是否由 timeout 触发,避免把网络错误误判为超时
- 主请求失败后,不要直接发起 fallback;先检查 signal.aborted 状态,双重确认再执行降级分支
- 降级请求本身也要带自己的 timeout(通常设得更长),防止 fallback 自身卡死,造成二次阻塞
实施多级降级:网络 → 缓存 → 默认值
一次资源获取应有清晰的来源标记和回退阶梯,而非只有“成功”或“失败”两种结果。
- 优先查内存缓存(如 Map 或 WeakMap 中近期解析过的结构化数据)
- 未命中则读取 localStorage / IndexedDB,要求缓存项含时间戳和版本号,支持过期判断
- 缓存也失效时,返回预置轻量默认值(如空数组、占位对象),并统一标记 source: "default-fallback"
- 所有分支返回结构一致,包含 data、source、timestamp 字段,便于监控与灰度分析
兼容性降级走独立路径,不靠 polyfill 模拟
对不支持 AbortController 或 Promise.race 的旧环境(如 IE11、Android 4.4),不能靠 polyfill 打补丁,而应启用完全隔离的逻辑链。
- 通过 'signal' in AbortController.prototype && typeof Promise.race === 'function' 检测,决定走现代路径还是 legacy 路径
- legacy 路径用 setTimeout + xhr.abort() 实现粗粒度超时,并配合手动维护的请求状态 map 防止重复提交
- 模块加载层面,用动态 script + define 注册替代 import,每个模块暴露 load() 和 unload() 接口,支持按需启停
内建可观测性:每一步都留痕
自动化降级若无法被感知,就等于没有降级。关键节点必须自动注入上下文日志。
- 记录每次请求的发起时间、目标 URL、配置 timeout、实际耗时
- 降级触发时,打点包含原始错误、fallback 类型、是否命中缓存、缓存项时间戳
- 所有日志携带 traceId 和 spanId,天然接入现有分布式追踪体系











