深入讲解如何使用 JavaScript 全局拦截 Ajax 与 Fetch 网络请求状态,结合活跃请求计数器(Active Request Counter)实现加载动画(Loading)的自动显示与隐藏,彻底解决并发竞态与画面闪烁问题。
JS监听Ajax/Fetch请求状态自动控制加载动画显隐
时间:2026-11-17
浏览:348
文章目录
在现代 Web 应用中,自动管理加载动画的核心方案是在全局拦截原生 XMLHttpRequest 和 window.fetch,并配合一个活跃请求计数器(Active Request Counter)。无论业务代码中发起多少个并发或交错重叠的网络请求,只要在请求发出时将计数加一(当计数从 0 变为 1 时显示动画),并在每个请求终结时将计数减一(只有当计数完全归零时才隐藏动画),就能在不修改任何既有接口调用逻辑的前提下,彻底杜绝加载状态错乱和界面频繁闪烁的问题。
一、为什么单个请求控制加载动画行不通?
在许多初级项目中,开发者习惯在每个请求函数内部手动控制 Loading。例如在发起请求前调用 showLoading(),在回调函数或 Promise.then() 中调用 hideLoading()。当页面只有一个简单的数据接口时,这种方式尚能工作;但在真实的业务场景下,页面往往会在初始化或用户交互时并发发起多个请求。
如果依赖单请求自身的回调去控制全局动画,必然会触发经典的竞态失效缺陷:
- 提前关闭风险:假设页面同时触发了请求 A(耗时 800ms)和请求 B(耗时 200ms)。请求 B 率先完成并调用了
hideLoading(),此时全局动画立即消失,但实际上请求 A 仍在网络传输中,用户看到页面已停止加载却无法操作,甚至误以为系统卡死。 - 界面剧烈闪烁:当多个短耗时请求在毫秒级别内前后触发时,Loading 遮罩层会频繁经历“打开-关闭-打开-关闭”的切换,造成极为糟糕的视觉闪烁体验。
- 高耦合与维护成本:一旦页面涉及数十个业务 API,为每个接口单独编写 loading 变量或手动调用函数,会导致冗余代码散落在各个业务模块中,任何一处漏写
catch都会导致遮罩层永久卡在页面上。
解决这一问题的标准架构如图 1 所示:通过在底层切入网络 API(window.fetch 与 XMLHttpRequest.prototype),将所有网络流量透明分流至中央调度器(LoadingManager)。业务层代码无需关心动画的存在,由计数器统一仲裁 UI 状态。
二、核心机制:并发请求生命周期与计数器时序
活跃请求计数器的运行法则非常简单明确:
- 定义全局变量
activeCount = 0。 - 任意请求发起时:执行
activeCount++。若自增前的数值为 0(即发生 0 到 1 的状态跃迁),触发全局加载动画显示。 - 任意请求结束时(涵盖成功响应、HTTP 错误状态码、断网失败或主动取消):执行
activeCount--。若自减后的数值达到 0(即所有在途请求均已结算),触发全局加载动画隐藏。
从图 2 的时序对比可以直观看到,三个生命周期交错重叠的请求(A、B、C)在并行运行时,活跃计数呈现出 0 → 1 → 2 → 3 → 2 → 1 → 0 的动态波峰。单请求粗暴方案在 550ms 处(请求 C 结束)就会错误地提前关闭动画;而计数器方案则始终维持 Loading 状态,直到 850ms 最后一个在途请求(请求 B)完成时,才平滑隐藏动画,实现了全生命周期的精确覆盖。
三、加载控制中心(LoadingManager)设计
在切入网络层之前,我们需要首先将 Loading 的状态调度与 DOM 操作封装为一个独立的管理中心。为了优化视觉体验,调度中心还应集成短耗时防抖机制(Debounce Delay):如果网络请求在 200ms 以内极速完成,则完全不需要弹出加载框,避免闪烁;只有当请求持续时间超过阈值,才真正渲染遮罩。
// loading-manager.js
class LoadingManager {
constructor(options = {}) {
this.activeCount = 0;
this.delay = options.delay || 200; // 延迟显示时间(ms),防止快速请求闪烁
this.timer = null;
this.isLoadingVisible = false;
this.domElement = null;
this.initDOM();
}
// 创建全局 Loading 遮罩 DOM 结构
initDOM() {
const overlay = document.createElement('div');
overlay.id = 'global-network-loading';
overlay.setAttribute('aria-live', 'assertive');
overlay.innerHTML = `
<div class="loading-backdrop" style="position:fixed;top:0;left:0;width:100%;height:100%;background:rgba(255,255,255,0.7);z-index:99999;display:none;align-items:center;justify-content:center;transition:opacity 0.2s ease;">
<div class="loading-spinner-box" style="background:#FFFFFF;padding:20px 28px;border-radius:8px;box-shadow:0 4px 16px rgba(0,0,0,0.12);display:flex;align-items:center;gap:12px;">
<div style="width:22px;height:22px;border:3px solid #CBD7E3;border-top-color:#6B88A6;border-radius:50%;animation:global-spin 0.8s linear infinite;"></div>
<span style="color:#273849;font-size:14px;font-weight:500;">数据加载中...</span>
</div>
</div>
<style>
@keyframes global-spin {
0% { transform: rotate(0deg); }
100% { transform: rotate(360deg); }
}
</style>
`;
document.body.appendChild(overlay);
this.domElement = overlay.querySelector('.loading-backdrop');
}
// 请求发起,计数递增
show() {
this.activeCount++;
if (this.activeCount === 1) {
// 首次出现活跃请求,启动防抖定时器
this.timer = setTimeout(() => {
if (this.activeCount > 0) {
this.domElement.style.display = 'flex';
this.isLoadingVisible = true;
}
}, this.delay);
}
}
// 请求完成,计数递减
hide() {
// 下溢保护,防止非预期重复调用导致计数器出现负数
this.activeCount = Math.max(0, this.activeCount - 1);
if (this.activeCount === 0) {
// 清理尚未触发的延迟定时器
if (this.timer) {
clearTimeout(this.timer);
this.timer = null;
}
if (this.isLoadingVisible) {
this.domElement.style.display = 'none';
this.isLoadingVisible = false;
}
}
}
// 异常恢复与路由重置
reset() {
this.activeCount = 0;
if (this.timer) {
clearTimeout(this.timer);
this.timer = null;
}
if (this.domElement) {
this.domElement.style.display = 'none';
}
this.isLoadingVisible = false;
}
}
export const loadingManager = new LoadingManager();
Math.max(0, this.activeCount - 1) 可以杜绝计数器滑入负数区间,确保整个状态机绝对自愈。
四、核心实战:四大实现步骤与双引擎劫持
前端主要存在两种发送网络请求的途径:较新的 window.fetch API 以及传统的 XMLHttpRequest(Axios 浏览器端与早期 Ajax 库的底层基础)。要实现完整的全局监听,必须分别对两者进行无感代理。
步骤 1:劫持原生 Fetch API
window.fetch 是一个全局函数,劫持的方式是将其替换为自定义的包装函数,同时保留对原有 rawFetch 的引用。
在包装逻辑中,必须特别注意以下细节:
- 静默请求识别:通过检查请求头中的
X-Silent-Request: true或配置参数,允许业务层主动跳过全局 Loading(例如轮询打点、心跳探活接口)。 - 必须使用
Promise.prototype.finally:网络请求可能因超时、网络中断、DNS 解析失败或AbortController中止而抛出 Reject。无论成功与否,计数递减逻辑必须在finally块中执行。
// hook-fetch.js
import { loadingManager } from './loading-manager.js';
export function hookFetch() {
if (typeof window === 'undefined' || !window.fetch) return;
// 避免重复挂载
if (window.fetch.__isHooked__) return;
const rawFetch = window.fetch;
window.fetch = async function (...args) {
const [resource, config = {}] = args;
// 检查是否标记为静默请求
const isSilent =
(config.headers && (config.headers['X-Silent-Request'] === 'true' || config.headers['x-silent-request'] === 'true')) ||
(resource instanceof Request && resource.headers.get('x-silent-request') === 'true');
if (!isSilent) {
loadingManager.show();
}
try {
// 执行原生请求
const response = await rawFetch.apply(this, args);
return response;
} finally {
// 无论成功还是抛出异常,均严格递减计数
if (!isSilent) {
loadingManager.hide();
}
}
};
window.fetch.__isHooked__ = true;
}
步骤 2:代理 XMLHttpRequest 原型链
XMLHttpRequest 是一个构造函数,每一个 Ajax 实例都继承自 XMLHttpRequest.prototype。要监控其实例生命周期,最优雅的做法是重写其原型链上的 open 与 send 方法。
在监听请求结束状态时,很多开发者会分别绑定 load、error、abort 和 timeout 四个事件,这不仅容易发生重复监听,还可能遗漏某种极端边界。现代标准中,loadend 事件会在请求无论是成功完成、网络错误还是被主动 abort 之后必定且仅触发一次,是回收计数的最佳契机。
// hook-xhr.js
import { loadingManager } from './loading-manager.js';
export function hookXMLHttpRequest() {
if (typeof window === 'undefined' || !window.XMLHttpRequest) return;
const xhrProto = XMLHttpRequest.prototype;
// 避免重复劫持
if (xhrProto.__isHooked__) return;
const rawOpen = xhrProto.open;
const rawSend = xhrProto.send;
// 重写 open 方法:提取元信息与静默标记
xhrProto.open = function (method, url, ...rest) {
this.__reqMethod = method;
this.__reqUrl = url;
this.__isSilent = false;
this.__hasHandledEnd = false; // 防止 loadend 重复触发保护
return rawOpen.apply(this, [method, url, ...rest]);
};
// 扩展 setRequestHeader 拦截静默 Header
const rawSetRequestHeader = xhrProto.setRequestHeader;
xhrProto.setRequestHeader = function (header, value) {
if (header && header.toLowerCase() === 'x-silent-request' && value === 'true') {
this.__isSilent = true;
}
return rawSetRequestHeader.apply(this, [header, value]);
};
// 重写 send 方法:发起请求前自增计数,并绑定统一回收监听
xhrProto.send = function (...args) {
if (!this.__isSilent) {
loadingManager.show();
// 绑定 loadend 事件统一回收计数
const onEnd = () => {
if (!this.__hasHandledEnd) {
this.__hasHandledEnd = true;
loadingManager.hide();
this.removeEventListener('loadend', onEnd);
}
};
this.addEventListener('loadend', onEnd);
}
return rawSend.apply(this, args);
};
xhrProto.__isHooked__ = true;
}
XMLHttpRequest 实现。劫持了 XMLHttpRequest.prototype 后,所有的 Axios 请求将直接受到自动监听,无需再通过 axios.interceptors 反复封装。
五、工程化落地:边界防御与异常处理体系
在实际生产部署中,单纯完成 API 劫持并不能直接上线。任何一个在极端情况下卡死的 Loading 蒙层都会直接阻断用户所有交互。我们必须建立完备的防御体系。
1. 针对超长挂起请求的兜底超时(Deadlock Guard)
当后端接口无响应且未配置超时参数时,或者由于网关异常导致连接处于假死状态,请求可能挂起数分钟。为此,调度中心应当记录每一个被触发的请求时间戳。如果全局处于 Loading 状态超过安全阈值(例如 15 秒),应当记录警报日志并强制调用 reset(),解开用户界面遮罩。
2. 单页面应用(SPA)路由切换时的状态清空
在 Vue Router 或 React Router 中,当用户在请求未完成时主动点击导航切换到了新页面,旧组件被销毁但其发起的请求可能仍在后台传输或已被取消。为了防止上一页残留的计数影响新页面,建议在路由守卫的 afterEach 回调中调用 loadingManager.reset()。
3. 微前端(Qiankun / Wujie)与沙箱隔离防范
如果项目采用微前端架构,主应用与子应用可能拥有不同的 window 上下文,或者在子应用多次卸载挂载时反复执行劫持脚本。我们在代码中设置的 __isHooked__ 标志位正是为了防止重复包装导致“一次请求递增两次、递减一次”的计数灾难。
六、快速验证与测试方法
在完成上述模块组装后,我们可以在控制台运行以下测试脚本,模拟多种复杂并发场景,验证 Loading 是否符合预期:
// 模拟并发测试
async function runConcurrencyTest() {
console.log('--- 测试开始:并发触发 3 个长短不同的请求 ---');
// 请求 1: 耗时 700ms 的 Fetch
const p1 = fetch('https://httpbin.org/delay/1').then(() => console.log('请求 1 (Fetch) 结束'));
// 请求 2: 耗时 300ms 的 Fetch
const p2 = fetch('https://httpbin.org/delay/0').then(() => console.log('请求 2 (Fetch) 结束'));
// 请求 3: XHR 请求
const p3 = new Promise((resolve) => {
const xhr = new XMLHttpRequest();
xhr.open('GET', 'https://httpbin.org/get');
xhr.onloadend = () => {
console.log('请求 3 (XHR) 结束');
resolve();
};
xhr.send();
});
// 请求 4: 静默请求(不应触发 Loading 计数)
const p4 = fetch('https://httpbin.org/get', {
headers: { 'X-Silent-Request': 'true' }
}).then(() => console.log('请求 4 (静默请求) 结束'));
await Promise.all([p1, p2, p3, p4]);
console.log('--- 所有请求结束:当前活跃计数 activeCount 应为 0 ---');
console.log('当前计数状态:', loadingManager.activeCount);
}
七、关键要点总结表
| 技术模块 | 实现关键点 | 规避的潜在隐患 |
|---|---|---|
| 计数器调度模型 | activeCount 仅在 0 变 1 时开、1 归 0 时关 |
消除多请求并发下的提前关闭(Race Condition) |
| Fetch 代理 | 在 Promise.prototype.finally 中递减计数 |
捕获 AbortController 取消与网络硬中断导致的泄漏 |
| XHR 代理 | 监听 loadend 统一收口事件,而非分散绑定 |
避免在 timeout 或 error 场景下漏减计数 |
| 体验防抖机制 | 200ms 延迟展示定时器(Debounce) | 防止极快接口(如本地缓存)导致页面加载动画一闪而过 |
| 下溢防御机制 | Math.max(0, activeCount - 1) 强制截断 |
防止异常逻辑多次触发 hide() 导致计数器滑入负数 |
通过建立统一的活跃计数中心,并从 Fetch 和 XMLHttpRequest 两个网络底层入口切入,前端工程可以在完全保持业务代码解耦纯净的同时,实现全局 Loading 显隐的高度自动化与健壮运行。
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。