JavaScript 中怎么在接口调用中使用拦截器统一处理响应

星晨姑娘_8945

星晨姑娘_8945

2026-09-13

321人浏览

原创

javascript接口响应拦截主要通过axios拦截器或封装fetch实现:axios用interceptors.response.use统一处理成功/失败响应;fetch需手动封装request函数,在promise链中校验状态码、解析数据并抛出错误;核心用于状态码映射、自动重试、日志与缓存,需避免异步副作用和修改原始响应对象。

javascript 中怎么在接口调用中使用拦截器统一处理响应

在 JavaScript 中,接口调用的响应拦截通常借助请求库(如 Axios)实现,原生 fetch 不直接支持拦截器,但可通过封装模拟类似能力。核心思路是:在请求发出后、业务代码拿到响应前,统一检查状态、处理错误、解析数据或透传元信息。

使用 Axios 的响应拦截器

Axios 提供了开箱即用的 interceptors.response.use() 方法,是最常用的方式:

  • 第一个参数是成功回调,接收响应对象 response,可修改 response.data 或添加字段
  • 第二个参数是失败回调,接收错误对象 error,可用于统一捕获网络异常、HTTP 状态码错误(如 401、500)
  • 务必 return Promise.reject(error)throw error 以保证错误能被后续 .catch() 捕获

示例:

axios.interceptors.response.use(
  response => {
    // 假设后端统一返回 { code: 0, data: ..., msg: "" }
    if (response.data.code === 0) {
      return response.data.data; // 只返回业务数据,简化组件层使用
    } else if (response.data.code === 401) {
      localStorage.removeItem('token');
      window.location.href = '/login';
      return Promise.reject(new Error('登录已过期'));
    }
    return Promise.reject(new Error(response.data.msg || '请求失败'));
  },
  error => {
    if (error.response?.status === 401) {
      // 同上,兜底处理未被响应体拦截的情况
      localStorage.removeItem('token');
      window.location.href = '/login';
    } else if (!error.response) {
      // 网络错误或请求被取消
      console.error('网络异常,请检查连接');
    }
    return Promise.reject(error);
  }
);

封装 fetch 实现类拦截逻辑

若项目不使用 Axios,可用函数封装 fetch,在 Promise 链中插入统一处理:

Alibabacloud Sdk Client Initialization For Java
Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载
  • 定义一个 request(url, options) 函数,内部调用 fetch
  • .then() 中解析 JSON 并校验业务状态码
  • .catch() 中处理网络错误、超时等
  • 所有 API 调用都走这个函数,避免重复逻辑

示例:

async function request(url, options = {}) {
  try {
    const res = await fetch(url, {
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${localStorage.getItem('token')}`,
        ...options.headers
      },
      ...options
    });

    const data = await res.json();

    if (!res.ok) {
      throw new Error(data.msg || `HTTP ${res.status}`);
    }

    if (data.code !== 0) {
      throw new Error(data.msg || '业务异常');
    }

    return data.data; // 统一透出业务数据
  } catch (err) {
    if (err.name === 'AbortError') {
      console.warn('请求已取消');
    }
    throw err;
  }
}

// 使用
request('/api/user').then(user => console.log(user));

拦截器中常见处理场景

响应拦截不是“万能胶”,应聚焦可复用、与业务解耦的逻辑:

  • 状态码映射:将后端自定义 code 映射为前端可识别的错误类型(如 code=1001 → TOKEN_EXPIRED)
  • 自动重试:对偶发性 502/503 错误,在拦截器中判断并发起重试(注意限制次数和间隔)
  • 响应日志:开发环境打印 URL、耗时、响应大小,便于排查(生产环境关闭)
  • 缓存控制:根据响应头 Cache-Control 或自定义字段,自动存入内存缓存或 IndexedDB

注意事项与避坑点

拦截器看似简单,实际容易引入隐性问题:

  • 不要在拦截器里做异步副作用(如弹窗、跳转),除非明确需要且已考虑竞态(例如多个请求同时 401,只应跳一次)
  • 避免修改原始响应对象(如 response.config),可能影响其他拦截器或调试
  • 拦截器执行顺序遵循“先进后出”,响应拦截器按注册顺序逆序执行
  • 如果用了多个实例(如不同 baseURL 的 axios 实例),需分别为每个实例配置拦截器

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

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

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

下载

相关标签:

javascript java

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

相关专题

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

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

2023.06.20

4066

5

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

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

2023.07.04

1029

3

js四舍五入
js四舍五入

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

2023.07.04

3964

6

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

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

2023.09.01

820

4

JavaScript转义字符
JavaScript转义字符

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

2023.09.04

1696

5

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

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

2023.09.04

2985

4

如何启用JavaScript
如何启用JavaScript

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

2023.09.12

3893

6

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

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

2023.09.20

2460

5

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

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

2023.09.20

808

7

热门下载

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

精品课程

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

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 11.9万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.5万人学习