axios-ultra

优点：
1.一个全平台请求库 支持普通web、taro、uniapp、小程序
2.类型友好提示，易扩展
3.通过全局配置实现，直接获取接口data，而不需要每次请求总是判断resp.code == 200再获取resp.data
4.通过全局配置实现，请求生命周期自动loading和message提示
5.内置刷新token逻辑，只需实现processRefreshTokenLogic逻辑即可

Useage

npm i axios-ultra
or
yarn add axios-ultra

import HttpRequest from "axios-ultra";
import type {AxiosUltraErrorMessageOption, AxiosUltraLoadingOption, AxiosUltraSuccessMessageOption, AxiosUltraToast} from "axios-ultra";
import {message} from 'antd'

const httpRequest = new HttpRequest({
    baseURL: '/api',
    processHeaderToken(config) {
        Object.assign(config.headers, {
            Authorization: localStorage.getItem('token') || ''
        })
    },
    //处理刷新token逻辑
    async processRefreshTokenLogic(defaultOptions) {
        await httpRequest.get('/refreshToken', {}, defaultOptions);
        localStorage.setItem('token', '1')
    },
    //实现提供自动提示
    toast: {
        loading(option: AxiosUltraLoadingOption) {
            return message.loading({
                content: option.title,
                duration: 999999
            })
        },
        success(option: AxiosUltraSuccessMessageOption) {
            message.success({
                content: option.title,
            })
        },
        error(option: AxiosUltraErrorMessageOption) {
            message.error({
                content: option.title,
            })
        },
    }
});
//data 直接是接口响应的data 内置默认取接口最后的数据
const data = httpRequest.get('/api1', {}, {message: true, loading: true});
const data1 = httpRequest.get('/api1', {}, {message: {error: false, message: '操作成功'}, loading: '加载中...'});

Type Description

/**
 * by zlm(执着)
 */
import {AxiosRequestConfig} from "axios";

/**
 * 接口响应
 */
export interface AxiosUltraAPIResponse {

}

/**
 * 失败消息提示
 */
export interface AxiosUltraErrorMessageOption {
    title: string
}

/**
 * 成功消息提示
 */
export interface AxiosUltraSuccessMessageOption {
    title: string
}

/**
 * 消息提示
 */
export type AxiosUltraMessageOption = {
    error?: AxiosUltraErrorMessageOption | boolean | string;
    success?: AxiosUltraSuccessMessageOption | boolean | string;
}


/**
 * loading
 */
export interface AxiosUltraLoadingOption {
    title: string
}

/**
 * 消息提示 接口
 */
export type AxiosUltraToast = {
    /**
     * 成功提示
     * @param option
     */
    success(option: AxiosUltraSuccessMessageOption);
    /**
     * 错误提示
     * @param option
     */
    error(option: AxiosUltraErrorMessageOption);
    /**
     * 加载提示，返回关闭方法
     * @param option
     */
    loading(option: AxiosUltraLoadingOption): () => void;
}

export interface AxiosInterceptorObject {
    /**
     * 请求拦截
     * @param config
     */
    requestInterceptor?: (config: any) => Promise<any>;
    requestInterceptorCatch?: (err: any) => Promise<any>;
    /**
     * 响应拦截
     * @param response
     */
    responseInterceptor?: (response: any) => Promise<any>;
    responseInterceptorCatch?: (err: any) => Promise<any>;
}

//请求参数
export interface AxiosUltraRequestConfigOption extends AxiosRequestConfig, Record<string, any> {
    /**
     * 是否loading
     */
    loading?: AxiosUltraLoadingOption | string | boolean;
    /**
     * 是否消息提示
     */
    message?: AxiosUltraMessageOption | string | boolean;
    /**
     * 提示配置 桥接
     */
    toast?: AxiosUltraToast;
    /**
     * 外部传入是否请求成功
     * @param resp
     */
    isSuccess?: (resp: any) => Boolean;
    /**
     * 是否获取api响应的数据
     */
    getApiResponse?: boolean;
    /**
     * 是否含有完整的http响应（一般用于获取头部信息的请求）
     */
    getResponse?: boolean;
    /**
     * 成功情况下获取data
     * @param resp
     */
    getSuccessData?: (resp: any) => any;
    /**
     * 获取接口消息提示
     * @param resp
     */
    getApiMessage?: (resp: any) => string;
    /**
     * 拦截器
     */
    interceptor?: AxiosInterceptorObject;

    /**
     * 是否需要token
     */
    needHeaderToken?: boolean;
    /**
     * 处理
     * @param config
     */
    processHeaderToken?: (config: AxiosUltraRequestConfigOption) => void;
    /**
     * token刷新重试
     */
    refreshTokenRetryCount?: number;
    /**
     * 开启刷新token
     */
    enableRefreshToken?: boolean;
    /**
     * 处理刷新token逻辑
     * @param defaultOptions
     */
    processRefreshTokenLogic?: (defaultOptions: AxiosUltraRequestConfigOption) => void | Promise<void>;

}

Extend Type

//一定要加，不然不知道扩展哪个库
import AxiosUltra from 'axios-ultra'

declare module 'axios-ultra' {
    /**
     * 扩展接口响应参数
     */
    export interface AxiosUltraAPIResponse {
        code: number;
        data: any;
        message: string
    }

    /**
     * 扩展错误消息提示传参
     */
    export interface AxiosUltraErrorMessageOption {

    }

    /**
     * 扩展成功消息提示传参
     */
    export interface AxiosUltraSuccessMessageOption {

    }
}