【前端】基于 Promise 的 HTTP 客户端工具Axios 详解

Axios 详解


1. 简介
  • 定义:Axios 是一个基于 Promise 的 HTTP 客户端,用于浏览器和 Node.js 环境,简化 HTTP 请求的发送和处理。
  • 核心特点 :
    • 支持 Promise API,可链式调用。
    • 自动转换 JSON 数据。
    • 支持请求/响应拦截。
    • 可取消请求。
    • 客户端支持防抖和跨域请求。

2. 核心功能
功能 描述
GET/POST 请求 发送 GET、POST 等 HTTP 方法请求。
Promise 支持 通过 .then() 和 .catch() 处理异步操作。
拦截器 在请求发送前或响应返回后拦截并修改请求/响应数据。
取消请求 通过 CancelToken 取消未完成的请求。
响应类型 支持 response.data、response.status 等详细响应信息。

3. 基本用法示例
javascript 复制代码
// 安装(Node.js 环境)
npm install axios

// 发送 GET 请求
axios.get('/api/users', {
  params: { id: 1 } // 查询参数
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Error:', error);
});

// 发送 POST 请求
axios.post('/api/create', {
  name: 'Alice',
  age: 25
}, {
  headers: { 'Content-Type': 'application/json' }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

4. 配置选项
配置项 描述
baseURL 请求的基础路径(全局或实例配置)。
timeout 请求超时时间(毫秒)。
headers 自定义请求头(如 Authorization)。
withCredentials 是否允许跨域请求携带凭证(如 Cookie)。
paramsSerializer 自定义参数序列化函数(如处理对象为 URL 参数)。
javascript 复制代码
// 全局配置示例
axios.defaults.baseURL = 'https://api.example.com';
axios.defaults.timeout = 5000;

5. 拦截器
  • 请求拦截器:在请求发送前修改配置:

    javascript 复制代码
    axios.interceptors.request.use(config => {
      // 添加 Token
      config.headers.Authorization = `Bearer ${localStorage.token}`;
      return config;
    }, error => Promise.reject(error));
  • 响应拦截器:在响应返回后处理数据或错误:

    javascript 复制代码
    axios.interceptors.response.use(response => {
      return response.data; // 简化后续 .then() 的数据获取
    }, error => {
      if (error.response.status === 401) {
        // 处理未授权错误(如跳转登录页)
      }
      return Promise.reject(error);
    });

6. 错误处理
  • 常见错误类型 :
    • error.response:包含状态码和响应数据(如 404、500)。
    • error.request:请求已发送但无响应。
    • error.message:其他错误信息(如网络问题)。
javascript 复制代码
axios.get('/api/invalid')
.catch(error => {
  if (error.response) {
    console.log('Status:', error.response.status);
    console.log('Error Data:', error.response.data);
  } else {
    console.log('Request Failed:', error.message);
  }
});

7. 与 Fetch 的对比
特性 Axios Fetch
Promise 支持 原生支持 原生支持
请求/响应拦截 支持 不支持
取消请求 支持 需通过 AbortController 实现
JSON 自动解析 自动转换 需调用 response.json()
浏览器兼容性 兼容性好(需 polyfill 旧版浏览器) 需 polyfill IE 等旧版浏览器

8. 常见场景
  • 跨域请求 :通过 CORS 配置或代理解决(如在开发环境配置代理)。

  • 上传文件 :

    javascript 复制代码
    const file = document.querySelector('input[type="file"]').files[0];
    const formData = new FormData();
    formData.append('file', file);
    axios.post('/api/upload', formData, {
      headers: { 'Content-Type': 'multipart/form-data' }
    });

9. 最佳实践
  1. 避免全局配置污染 :通过 axios.create() 创建实例,隔离不同环境配置。
  2. 统一错误处理:通过拦截器集中处理 Token 过期、网络错误等通用问题。
  3. 取消重复请求:在组件卸载时取消未完成的请求,避免内存泄漏。
  4. 合理设置超时 :根据接口复杂度调整 timeout 防止阻塞。
javascript 复制代码
// 创建实例示例
const apiClient = axios.create({
  baseURL: '/api',
  timeout: 10000
});
相关推荐
拖孩8 小时前
# 我又用 AI 做了个小程序:24 天,记录我这辈子认识的人
前端·后端·微信小程序
徐小夕8 小时前
深度拆解 Design Agent:LangChain 出品,AI 设计从「好看」走向「可用」
前端·vue.js·github
离凌寒8 小时前
一、关于qt编写的mqtt工具与tcp工具使用说明
网络·网络协议·tcp/ip
如夏倾城9 小时前
五大远程桌面协议:RDP、SSH、VNC/RFB、Citrix ICA/HDX 与 VMware Blast Extreme
运维·windows·网络协议·安全·自动化·ssh·远程工作
1-1=09 小时前
Vue 表单数据和过滤器
前端·javascript·vue.js
羽落•无痕(苏晗默)9 小时前
华为数通IA——14、网络服务与应用:TCP/UDP 传输层协议与 FTP、Telnet、SSH 实践
网络·网络协议·tcp/ip·网络安全·华为·udp·信息与通信
0xBADCODE9 小时前
2026 工业互联网安全大赛 · 全国预选赛题解系列密码学方向 crypto-5
网络·安全·web安全·网络安全·系统安全·密码学
oil欧哟9 小时前
Oil UI 的设计思路与日常使用方式:让 AI 摆脱默认模板并保持多页面风格统一
前端
恋猫de小郭9 小时前
Jetpack Compose 1.13 发布,憋了这么久终有交代了
android·前端·flutter
头发还在的女程序员10 小时前
智慧物业源码解析:房屋档案与业主变更怎样保持历史业务连续
前端·javascript·vue.js·物业管理·小区物业·智慧物业