vue3 + Ts 中 如何 封装 axios

1.安装 axios 和 Element-plus

yarn add axios
//  因为在请求中使用到了 loading
yarn add element-plus@2.2.12

在 request 文件中 创建 三个文件： type.ts 、 index.ts 、 config.ts
1.定义接口类型：创建 type.ts 文件

// 引入 axios 
import type { AxiosRequestConfig, AxiosResponse } from 'axios';

// 定义接口
export interface HRequestInterceptors<T = AxiosResponse> {
  // 请求拦截器（成功与失败）
  requestInterceptors?: (config: AxiosRequestConfig) => AxiosRequestConfig;
  requestInterceptorsCatch?: (error: any) => any;
  // 相应拦截器（成功与失败） 
  responseInterceptor?: (res: T) => T;
  responseInterceptorCatch?: (error: any) => any;
}
// 继承接口: 定义每个请求的拦截器并且设置请求状态显示
export interface HRequestConfig<T = AxiosResponse> extends AxiosRequestConfig {
  interceptors?: HRequestInterceptors<T>;
  // 是否展示请求加载状态
  showLoading?: boolean;
}

2.根据1 type 使用 class 封装axios

//  引入axios
import axios from 'axios';
import type { AxiosInstance } from 'axios';

// 引入类型
import type { HRequestInterceptors, HRequestConfig } from './type';
// 引入加载等待组件
import { ElLoading } from 'element-plus';
// 引入loading 类型：不同版本路劲不同
import { LoadingInstance } from 'element-plus/es/components/loading/src/loading';

// 请求加载显示状态
const DEFAULT_LOADING = false;
class HRequest {
 // 类型
  instance: AxiosInstance;
  interceptors?: HRequestInterceptors;
  showLoading: boolean;
  loading?: LoadingInstance;

  constructor(config: HRequestConfig) {
    // 创建请求
    this.instance = axios.create(config);

    // 保存基本信息
    this.interceptors = config.interceptors;

    this.showLoading = config.showLoading ?? DEFAULT_LOADING;

    // 使用拦截器
    // 1.从config中获取的拦截器是对应的实例的拦截器
    this.instance.interceptors.request.use(
      this.interceptors?.requestInterceptors,
      this.interceptors?.requestInterceptorsCatch
    );

    // 响应拦截类型
    this.instance.interceptors.response.use(
      this.interceptors?.responseInterceptor,
      this.interceptors?.responseInterceptorCatch
    );

    // 2.所有示实例的请求拦截
    this.instance.interceptors.request.use(
      (config) => {
        if (this.showLoading) {
          this.loading = ElLoading.service({
            lock: true,
            text: '请求加载中...',
            background: 'rgba(255,255,255,0.5)'
          });
        }
        return config;
      },
      (err) => {
        return err;
      }
    );
    // 所有实例响应拦截
    this.instance.interceptors.response.use(
      (res) => {
        // 通过http的错误码
        // 服务器返回的status
        const data = res.data;
        // 清除loading
        this.loading?.close();
        if (data.returnCode === '-1001') {
          console.log('请求失败,错误信息');
        } else {
          return data;
        }
      },
      (err) => {
        // 4xx -> 5xx 在这里拦截
        if (err.response.status == 404) {
          console.log('404 的错误');
        }
        return err;
      }
    );
  }

  request<T>(config: HRequestConfig<T>): Promise<T> {
    return new Promise((resolve, reject) => {
      // 1. 单个请求的cofig 的处理
      if (config.interceptors?.requestInterceptors) {
        config = config.interceptors.requestInterceptors(config);
      }
      // 判断是否显示loading
      if (config.showLoading) {
        this.showLoading = config.showLoading;
      }
      this.instance
        .request<any, T>(config)
        .then((res) => {
          if (config.interceptors?.responseInterceptor) {
            res = config.interceptors.responseInterceptor(res);
          }
          // 不影响下一个loading 的使用
          this.showLoading = DEFAULT_LOADING;
          // 返回结果
          resolve(res);
        })
        .catch((err) => {
          // 不影响下一个loading 的使用
          this.showLoading = DEFAULT_LOADING;
          reject(err);
        });
    });
  }

  // 对request 二次封装
  get<T>(config: HRequestConfig<T>): Promise<T> {
    return this.request<T>({ ...config, method: 'GET' });
  }
  post<T>(config: HRequestConfig<T>): Promise<T> {
    return this.request<T>({ ...config, method: 'POST' });
  }
  put<T>(config: HRequestConfig<T>): Promise<T> {
    return this.request<T>({ ...config, method: 'PUT' });
  }
  delete<T>(config: HRequestConfig<T>): Promise<T> {
    return this.request<T>({ ...config, method: 'DELETE' });
  }
}
export default HRequest;

3.创建 config.ts 文件

// 根据相关开发环境进行获取 BASEURL
export const BASE_URL = process.env.VUE_APP_BASE_API;
// 请求等待时间
export const TIME_OUT = 1000;
// export { BASE_URL, TIME_OUT };

3.新建 serivce统一出口

import HRequest from './request';
// 
import { BASE_URL, TIME_OUT } from './request/config';

import localCache from '@/utils/cache';

// 携带参数
const hRequest = new HRequest({
  baseURL: BASE_URL,
  timeout: TIME_OUT,
  interceptors: {
    requestInterceptors: (config) => {
      //  获取token 根据 自己 对token存储 获取
      const token = localCache.getCache({ key: 'token' });
      if (token && config.headers) {
        config.headers.Authorization = `Bearer ${token}`;
      }
      return config;
    },
    requestInterceptorsCatch(error) {
      return error;
    },
    responseInterceptor: (res) => {
      return res;
    },
    responseInterceptorCatch(error) {
      return error;
    }
  }
});
export default hRequest;

5.最后定义请求接口 和 使用

import hRequest from '../index';

// 参数类型
interface IData {}
// 返回结果类型 
interface IResult{}

// url
enum LoginAPI {
  AccontLogin = '/login'
}

// 导出接口 showLoading：loading显示 ：默认情况下为不展示
export function accountLoginRequst(data:IData) {
  return hRequest.post<IResult>({
    url: LoginAPI.AccontLogin,
    data，
    showLoading: true
  });
}

// 使用
accountLoginRequst({userName:'admin',password:'123456'}).then(res=>{
  console.log(res)
})