JS 中怎么用拦截器(Interceptor)模式封装带有自动重试的请求库

小辰小哥_7979

小辰小哥_7979

2026-10-23

902人浏览

原创

javascript无原生拦截器,但可通过axios拦截器或fetch+高阶函数封装实现,核心是请求/响应前后期处理及基于错误类型、幂等性、退避策略的可控重试。

js 中怎么用拦截器(interceptor)模式封装带有自动重试的请求库

JavaScript 中没有原生的“拦截器(Interceptor)”类型,但可以通过函数式组合、类封装或请求库(如 Axios)的拦截机制来实现类似效果。要封装一个带自动重试能力的请求库,核心是:在发起请求前/后插入逻辑(如加 token、日志、错误处理),并在失败时按策略重新发起请求。

用 Axios 实现拦截器 + 自动重试

Axios 原生支持请求/响应拦截器,并可通过 cancel token 或 promise 链控制重试。关键点在于:避免无限重试、区分可重试错误、控制间隔时间。

  • 使用 request interceptor 统一添加 headers、鉴权信息
  • 使用 response interceptor 捕获错误,对网络失败、5xx、部分 4xx(如 408、429)触发重试
  • 重试逻辑不写在拦截器内(易导致递归),而是封装为独立函数,在响应拦截中调用
  • 每次重试应带退避(如指数退避),并限制最大次数(如 3 次)

手动封装轻量请求函数(无第三方依赖)

若不想引入 Axios,可用 fetch + Promise 封装。通过高阶函数注入“拦截行为”,再用递归或循环实现重试。

chartjs-reporter
chartjs-reporter

此技能用于在用户需要将结构化数据(查询结果、CSV 摘要、JSON 记录或 Python 字典/列表)转换为独立的 HTML 页面时使用。

下载
  • 定义 interceptRequest:接收原始配置,返回增强后的配置(如自动加 Authorization)
  • 定义 interceptResponse:接收 response 或 error,决定是否重试或抛出业务错误
  • 主函数 retryFetch(url, options, { maxRetries = 2, delay = 1000 }) 内部调用拦截函数,并用 setTimeout 或 Promise.delay 控制重试节奏
  • 注意:fetch 不会因 HTTP 状态码(如 404、500)reject,需手动 if (!res.ok) throw new Error(...)

重试策略的关键细节

盲目重试可能加重服务压力或掩盖真实问题,需有判断依据。

  • 只重试幂等请求:默认仅对 GET、HEAD、OPTIONS 重试;POST 等非幂等方法需显式开启(如传 idempotent: true)
  • 跳过特定错误:400(参数错误)、401(需登录)、403(权限不足)通常不应重试;而网络中断、502、504、超时更适合重试
  • 记录重试过程:在拦截器中打日志(如 Retry #1 for /api/data...),便于排查
  • 取消重复请求:配合 AbortController,当新请求发出时取消上一个未完成的请求(尤其适用于搜索建议等场景)

一个可直接用的最小示例(基于 fetch)

以下是一个简明、可扩展的封装:

const createApiClient = (baseURL = '') => {
  const defaultOptions = { maxRetries: 2, retryDelay: 1000 };
<p>const withAuth = (options) => ({
...options,
headers: {
'Authorization': <code>Bearer ${localStorage.getItem('token') || ''}</code>,
...options.headers
}
});</p><p>const shouldRetry = (error, attempt) => {
if (attempt > defaultOptions.maxRetries) return false;
if (error.name === 'AbortError') return false;
if (error.message.includes('failed to fetch')) return true; // 网络异常
if (error.responseStatus && [502, 503, 504].includes(error.responseStatus)) return true;
return false;
};</p><p>const request = async (url, options = {}) => {
const config = { ...defaultOptions, ...options };
const finalURL = baseURL + url;
let lastError;</p><pre class="brush:php;toolbar:false;">for (let i = 0; i  setTimeout(r, config.retryDelay * Math.pow(2, i)));
  }
}

throw lastError;

};

return { get: (u, o) => request(u, { method: 'GET', ...o }) }; };

// 使用 const api = createApiClient('/api'); api.get('/users').then(console.log).catch(console.error);

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

javascript js

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

5126

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1269

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

5044

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

980

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1916

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3605

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

4693

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

3080

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

988

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.3万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.7万人学习