Axios 实例配置指南

发布于:2025-08-31 ⋅ 阅读:(24) ⋅ 点赞:(0)

今天分享一段 Axios 实例配置的代码,用于 Web Front - End 项目的构建。

一、为什么使用 Axios

在前端项目中,与后端进行数据交互是必不可少的。Axios 是一个基于 Promise 的 HTTP 客户端,它提供了简洁的 API 和强大的功能,能够方便地发送 HTTP 请求。它支持浏览器和 Node.js,具有以下优点:

  • 简洁易用:提供简洁的 API,易于上手和使用。
  • 功能强大:支持请求和响应拦截器,可以方便地处理请求和响应数据。
  • 跨浏览器兼容:在各种浏览器环境中都能稳定运行。
  • 支持 Promise:基于 Promise 的设计,使得异步请求更加方便。

二、Axios 实例配置代码

1. 引入 Axios

首先,你需要安装 Axios。如果你使用的是 npm,可以通过以下命令安装:

npm install axios

然后,在你的项目中引入 Axios:

import axios from "axios";

2. 创建 Axios 实例

创建一个 Axios 实例,可以设置一些默认的配置,如基础 URL 和超时时间:

// 创建实例
const request = axios.create({
  baseURL: 'http://localhost:8000/', // 设置请求的基础路径
  timeout: 3000000, // 设置请求超时时间
});

3. 添加请求拦截器

请求拦截器可以在发送请求之前对请求进行处理,例如添加认证令牌、修改请求头等:

// 添加请求拦截器
request.interceptors.request.use(
  function (config) {
    // 在发送请求之前做些什么
    // 例如,添加认证令牌
    config.headers['Authorization'] = 'Bearer your-token';
    return config;
  },
  function (error) {
    // 对请求错误做些什么
    return Promise.reject(error);
  }
);

4. 添加响应拦截器

响应拦截器可以在收到响应后对响应数据进行处理,例如统一处理错误信息、转换响应数据格式等:

// 添加响应拦截器
request.interceptors.response.use(
  function (response) {
    // 2xx 范围内的状态码都会触发该函数。
    // 对响应数据做点什么
    return response.data; // 直接返回响应数据
  },
  function (error) {
    // 超出 2xx 范围的状态码都会触发该函数。
    // 对响应错误做点什么
    console.error('请求失败:', error);
    return Promise.reject(error);
  }
);

5. 导出 Axios 实例

将配置好的 Axios 实例导出,方便在其他地方使用:

// 导出
export default request;

6.总结实例配置的代码

总结下来整体实例配置的代码如下

// 引入
import axios from "axios";

// 创建实例
const request = axios.create({
  baseURL: 'http://localhost:8000/',
  timeout: 3000000,
})

// 添加请求拦截器
request.interceptors.request.use(function (config) {
    // 在发送请求之前做些什么
    return config;
  }, function (error) {
    // 对请求错误做些什么
    return Promise.reject(error);
  });

// 添加响应拦截器
request.interceptors.response.use(function (response) {
    // 2xx 范围内的状态码都会触发该函数。
    // 对响应数据做点什么
    return response;
  }, function (error) {
    // 超出 2xx 范围的状态码都会触发该函数。
    // 对响应错误做点什么
    return Promise.reject(error);
  });

// 导出
export default request

三、使用 Axios 实例

在你的项目中,你可以通过导入这个配置好的 Axios 实例来发送请求。例如:

import request from './path/to/your/axios-instance';

// 发送 GET 请求
request.get('/some-endpoint')
  .then(response => {
    console.log('响应数据:', response);
  })
  .catch(error => {
    console.error('请求错误:', error);
  });

// 发送 POST 请求
request.post('/some-endpoint', {
  key: 'value'
})
  .then(response => {
    console.log('响应数据:', response);
  })
  .catch(error => {
    console.error('请求错误:', error);
  });

四、总结

通过以上步骤,你可以轻松地在 Web 前端项目中配置和使用 Axios 实例。Axios 提供的强大功能和灵活的配置选项,能够帮助你更高效地进行前后端交互。

希望这篇博客对你有所帮助!如果你有任何问题或建议,欢迎在评论区留言。


网站公告

今日签到

点亮在社区的每一天
去签到