Typescript 封装 Axios * 方法实例
作者:Sergio_ 发布时间:2023-07-02 16:38:19
引言
对 axios 二次封装,更加的可配置化、扩展性更加强大灵活
通过 class 类实现,class 具备更强封装性(封装、继承、多态),通过实例化类传入自定义的配置
创建 class
严格要求实例化时传入的配置,拥有更好的代码提示
/**
* @param {AxiosInstance} axios实例类型
* @param {AxiosRequestConfig} axios配置项类型
*/
import type { AxiosInstance, AxiosRequestConfig } from 'axios'
class Http {
axios: AxiosInstance
constructor(config: AxiosRequestConfig) {
// 创建一个实例 axios.create([config])
this.axios = axios.create(config)
}
}
// 每实例化一个 axios 时,都是不同的 axios 示例,互不干扰
new Http({
baseURL:'qq.com';
timeout:60 * 1
});
new Http({
baseURL:'web.com'
});
axios.create([config])
const instance = axios.create({
baseURL: 'https://some-domain.com/api/',
timeout: 1000,
headers: {'X-Custom-Header': 'foobar'}
});
AxiosRequestConfig 的类型注解
export interface AxiosRequestConfig<D = any> {
url?: string;
method?: Method | string;
baseURL?: string;
transformRequest?: AxiosRequestTransformer | AxiosRequestTransformer[];
transformResponse?: AxiosResponseTransformer | AxiosResponseTransformer[];
headers?: AxiosRequestHeaders;
params?: any;
paramsSerializer?: (params: any) => string;
data?: D;
timeout?: number;
timeoutErrorMessage?: string;
withCredentials?: boolean;
adapter?: AxiosAdapter;
auth?: AxiosBasicCredentials;
responseType?: ResponseType;
responseEncoding?: responseEncoding | string;
xsrfCookieName?: string;
xsrfHeaderName?: string;
onUploadProgress?: (progressEvent: any) => void;
onDownloadProgress?: (progressEvent: any) => void;
maxContentLength?: number;
validateStatus?: ((status: number) => boolean) | null;
maxBodyLength?: number;
maxRedirects?: number;
beforeRedirect?: (options: Record<string, any>, responseDetails: {headers: Record<string, string>}) => void;
socketPath?: string | null;
httpAgent?: any;
httpsAgent?: any;
proxy?: AxiosProxyConfig | false;
cancelToken?: CancelToken;
decompress?: boolean;
transitional?: TransitionalOptions;
signal?: AbortSignal;
insecureHTTPParser?: boolean;
env?: {
FormData?: new (...args: any[]) => object;
};
}
封装 request(config)通用方法
/**
* axios#request(config)
* @param {*} config
* @returns {*}
*/
request(config: AxiosRequestConfig) {
return this.axios.request(config)
}
🏹 在 axios 中,request中的 config 参数与实例化时,axios.create(config)传入的参数是相同的,以下是 axios 方法具体参数
axios.request(config)
axios.get(url[, config])
axios.delete(url[, config])
axios.head(url[, config])
axios.options(url[, config])
axios.post(url[, data[, config]])
axios.put(url[, data[, config]])
axios.patch(url[, data[, config]])
axios.getUri([config])
封装- * (单个实例独享)
* 的hooks,在请求或响应被 then 或 catch 处理前拦截处理
🛹在请求中,如携带token、loading动画、header配置...,都是一些公有的逻辑,所以可以写到全局的 * 里面
🛵注意的是,可能存在某些项目请求,需要的公有的逻辑配置方式不一样,如 A项目:携带token、loading动画,B项目:携带token、header配置
🪂考虑到拦截方式不一样,固不能将 class 里的 * 写si,所以,需要通过不同的 axios 实例化传入自定义的 hooks( * ),实现单个实例独享,扩展性更强
在上面实例化 Http(Axios) 时,仅仅传入 axios 约定好的 config(AxiosRequestConfig)
new Http({
baseURL:'qq.com';
timeout:60 * 1
});
经过分析考虑,需要在实例化 Http 时,可以传入更多自定义的 hooks,扩展 axios。但是,在实例化时,直接传入定义好的 * 是不可行的 Why?
new Http({
baseURL: 'qq.com',
timeout: 60 * 1,
hooks: {}, // ERROR ❌❌⭕⭕
interceptor: () => {} // ERROR ⭕⭕❌❌
})
“hooks”不在类型“AxiosRequestConfig<any>”中,在上面 Http class 的 constructor 构造函数中,严格约束传入的参数应为AxiosRequestConfig类型(TS)
AxiosRequestConfig 中并不存在 hooks and interceptor类型的属性(AxiosRequestConfig 是由 axios 提供的一个类型注解)
🚀扩展 Http 自定义 *
对 AxiosRequestConfig 类型注解进行继承,使得在实例化时,可以传入扩展后的类型,定义:
🏜️IinterceptorHooks接口存储自定义的 * 函数、
🏙️IHttpRequestConfig接口继承 AxiosRequestConfig,并扩展自定义 * 的属性,属性类型为:IinterceptorHooks
🏜️`IinterceptorHooks` * Hook接口类型
import type { AxiosResponse, AxiosRequestConfig } from 'axios'
/**
* * 的hooks,在请求或响应被 then 或 catch 处理前拦截
* @param {beforeRequestInterceptor(?)} 发送请求之前 *
* @param {requestErrorInterceptor(?)} 请求错误 *
* @param {responseSuccessInterceptor(?)} 响应成功 *
* @param {responseFailInterceptor(?)} 响应失败 *
*/
interface interceptorHooks {
beforeRequestInterceptor: (config: AxiosRequestConfig) => AxiosRequestConfig
requestErrorInterceptor: (error: any) => any
responseSuccessInterceptor: (result: AxiosResponse) => AxiosResponse
responseFailInterceptor: (error: any) => any
}
export type IinterceptorHooks = Partial<interceptorHooks>
🌏Partial:Typescript 内置类型,将定义的类型注解全部变为可选的属性
🪂调用说明:axios.interceptors.request.use( beforeRequestInterceptor , requestErrorInterceptor );
请求之前 * 中(beforeRequestInterceptor),config 参数同样是与axios.create中的参数类型相同,为AxiosRequestConfig
注意:并不是IHttpRequestConfig
🏙️`IHttpRequestConfig` 类构造函数 config 接口类型
/**
* 实例化Http类的配置项参数,继承于AxiosRequestConfig
* @param {interceptors(?)} * Hooks
* @param {loading} 请求loading
* @param {...} 其它的配置项
* @param {AxiosRequestConfig} axios原生的配置选
*/
export interface IHttpRequestConfig extends AxiosRequestConfig {
interceptors?: IinterceptorHooks
}
🛵使用说明:
import { IHttpRequestConfig, IinterceptorHooks } from './types'
class Http {
axios: AxiosInstance
interceptors?: IinterceptorHooks
constructor(config: IHttpRequestConfig) {
// 解构自定义的属性
const { interceptors, ...AxiosRequestConfig } = config
this.axios = axios.create(AxiosRequestConfig)
// 存储自定义拦截Hooks or 直接 use() 使用
this.interceptors = interceptors
// 传入自定义请求 * Hooks
this.axios.interceptors.request.use(
this.interceptors?.beforeRequestInterceptor,
this.interceptors?.requestErrorInterceptor
)
// 传入自定义响应 * Hooks
this.axios.interceptors.response.use(
this.interceptors?.responseSuccessInterceptor,
this.interceptors?.responseFailInterceptor
)
}
}
// 扩展后的实例化...⛵
interceptors: {
// ... 自定义的拦截Hooks
beforeRequestInterceptor: (config: IHttpRequestConfig) => {
const token = localStorage.getItem('token')
if (token && config.headers) {
config.headers.Authorization = token
}
return config
}
}
封装- * (所有实例共享)
无论存在多少个实例的 Http,所有实例都会共享的同一套 * ,在 class 中固定的
class Http {
axios: AxiosInstance
// ...
constructor(config: IHttpRequestConfig) {
// ...单个实例独享 * 处理🍳
// 所有实例共享的拦截-请求 * 🍟
this.axios.interceptors.request.use(
function (config) {
// 在发送请求之前做些什么
return config
},
function (error) {
// 对请求错误做些什么
return Promise.reject(error)
}
)
// 所有实例共享的拦截-响应 *
this.axios.interceptors.response.use(
function (response) {
// 2xx 范围内的状态码都会触发该函数。
// 对响应数据做点什么
return response
},
function (error) {
// 超出 2xx 范围的状态码都会触发该函数。
// 对响应错误做点什么
return Promise.reject(error)
}
)
}
}
封装- * (单个请求独享)
在 axios 原生的 config(AxiosRequestConfig) 中,存在两个允许对请求or响应的数据进行转化处理:
// `transformRequest` 允许在向服务器发送前,修改请求数据
// 它只能用于 'PUT', 'POST' 和 'PATCH' 这几个请求方法
// 数组中最后一个函数必须返回一个字符串, 一个Buffer实例,ArrayBuffer,FormData,或 Stream
// 你可以修改请求头。
transformRequest: [function (data, headers) {
// 对发送的 data 进行任意转换处理
return data;
}],
// `transformResponse` 在传递给 then/catch 前,允许修改响应数据
transformResponse: [function (data) {
// 对接收的 data 进行任意转换处理
return data;
}],
由于transformRequest、transformResponse为 Axios 原生的API,所以尽量不去改变原有的 config API
🍟在需要不修改原生 Axios config 情况下,扩展单个请求独享的 * 时
🍳class 封装的方法:request(config: AxiosRequestConfig){}参数中不能再使用原生AxiosRequestConfig作为参数的注解
🫕前面提到过,request 中的 config 参数与实例化时传入的参数是相同的,所以在这里同样可以使用IHttpRequestConfig,作为 request 的参数注解
/**
* axios#request(config)
* @param {*} config
* @returns {*}
*/
request(config: AxiosRequestConfig) {
return this.axios.request(config)
}
// ...改为 AxiosRequestConfig -> IHttpRequestConfig
request(config: IHttpRequestConfig) {
// ... 在执行请求之前,执行单个请求独享的 * (?)
return this.axios.request(config).then(
// ...
)
}
具体代码实现:
// Http 封装的request🫕
request(config: IHttpRequestConfig) {
// 存在单个方法独享自定义 * Hooks(请求之前)🍀
if (config.interceptors?.beforeRequestInterceptor) {
// 立即执行beforeRequestInterceptor方法,传入config处理返回新的处理后的config
config = config.interceptors.beforeRequestInterceptor(config)
}
return this.axios
.request(config)
.then((result) => {
// 存在单个方法独享自定义 * Hooks(响应成功)🍃
if (config.interceptors?.responseSuccessInterceptor) {
// 立即执行beforeRequestInterceptor方法,传入config处理返回新的处理后的config
result = config.interceptors.responseSuccessInterceptor(result)
}
return result
})
.catch((error) => {
// 存在单个方法独享自定义 * Hooks(响应失败)🌄
if (config.interceptors?.responseFailInterceptor) {
// 立即执行beforeRequestInterceptor方法,传入config处理返回新的处理后的config
error = config.interceptors.responseFailInterceptor(error)
}
return error
})
}
// 执行 request 方法,传入 * 处理🌏,如:
axios.request({
url: '/api/addUser',
methed: 'POST',
interceptors: {
beforeRequestInterceptor:(config) => {
// ...处理config数据
return config
},
// ...请求错误处理不拦截
responseSuccessInterceptor:(result) => {
return result
}
}
})
注意:当存在单个方法独享自定义请求 * 时,应当在发送请求之前立即执行 beforeRequestInterceptor 方法,而不是通过传入到 use() 回调,执行请求拦截方法处理完之后返回一个经过处理的 config,在传入到请求方法中,发送请求
其它的单个方法独享自定义响应 * 一样
装修 Http class
返回经过
在响应数据时候(响应 * ),Axios 为数据在外层包装了一层对象,后台返回的数据就存在于 result 的 data 中,所以需要对数据再一步的处理,扒开最外层的皮
注意:Axios 在外层包装的对象数据,其实在某些情况下是需要 result 中的一些属性数据的,并不仅仅需要 data,比如返回格式为文件数据中,需要 headers 中的一些数据对文件进行处理,命名等...
这里的扒皮处理,逻辑应当属于所有实例共享的一个 * ,具体工具需要进行处理
// 所有实例共享的拦截-响应 *
this.axios.interceptors.response.use(
function (response) {
// 返回为文件流时,直接返回(文件需要单独处理)🪂
if (['blob', 'arraybuffer'].includes(response.request.responseType)) {
// if (response.headers['content-disposition']) {
// let fileName = response.headers['content-disposition'].split('filename=')[1]
// fileName = decodeURI(fileName)
// return {
// data: response.data,
// fileName
// }
// }
return response
}
// 根据业务码 or 状态码...进行判断
// 扒皮🛵
return response.data
},
function (error) {
// 超出 2xx 范围的状态码都会触发该函数。
// 对响应错误做点什么
return Promise.reject(error)
}
)
request 返回数据结构(DTO)
定义返回数据类型注解
// 最终数据类型注解
interface IDateType {
[key: string]: any
}
// axios 返回的数据类型注解,IDateType === T
interface IDTO<T = any> {
code: number
data: T
message: string
state: number
[prop: string]: any
}
// 请求方法,传入注解
axios.request<IDTO<IDateType>>({
url: '/api/addUser',
methed: 'POST',
})
由于在所有实例共享的响应 * 中,修改了返回的数据结构return response.data,到达方法响应 * 中的数据类型已经不再是AxiosResponse,导致在响应成功的 * 中类型错误无法赋值,以及.then返回的类型不正确无法返回,正确应该为DTO类型,解决方案:
// 修改 AxiosRequestConfig 类型注解,默认类型为原来的 AxiosResponse,传递到响应成功的拦截中进行泛型注解,用于在方法中重新修改返回的数据类型
// 最终的泛型类型注解到达 responseSuccessInterceptor 中
interface interceptorHooks<T> {
beforeRequestInterceptor: (config: AxiosRequestConfig) => AxiosRequestConfig
requestErrorInterceptor: (error: any) => any
responseSuccessInterceptor: (result: T) => T
responseFailInterceptor: (error: any) => any
}
export type IinterceptorHooks<T = AxiosResponse> = Partial<interceptorHooks<T>>
export interface IHttpRequestConfig<T = AxiosResponse> extends AxiosRequestConfig {
interceptors?: IinterceptorHooks<T>
}
// 修改 Http class request方法,通过 泛型 T 接受方法传达过来的 DTO 类型注解,传递到 IHttpRequestConfig 中修改 responseSuccessInterceptor 的参数类型注解以及返回值注解,在单个方法独享自定义 * 中就可以接受参数,并且返回正确的 DTO 类型数据
// 由于在下面的 this.axios.request() 方法中,返回的数据已经被上一个 * 扒皮修改了,返回的 result 类型注解中存在类型不正确情况(正确返回应返回response.data的类型注解),实际返回为 AxiosResponse<any,any>类型注解,导致数据返回到最外层方法时编辑器报错(最外层接受 DTO 类型),所以需要手动修改this.axios.request() 方法中返回的类型注解 this.axios.request<any, T>()
request<T>(config: IHttpRequestConfig<T>): Promise<T> {
return this.axios
.request<any, T>(config)
.then((result) => {
// 存在单个方法独享自定义 * Hooks(响应成功)
if (config.interceptors?.responseSuccessInterceptor) {
// 立即执行beforeRequestInterceptor方法,传入config处理返回新的处理后的config
result = config.interceptors.responseSuccessInterceptor(result)
}
return result
})
.catch((error) => {
// ...
})
}
* 执行顺序
由于在 constructor(构造函数) 代码顺序:单个实例独享 * -> 所有实例共享 * ->...
🌄单个实例独享 * 位于所有实例共享 * 之前,执行顺序为:
所有实例共享请求 * -> 单个实例独享请求 * -> 单个实例独享响应 * -> 所有实例共享响应 *
反之,则:
🌅所有实例共享 * 位于之前单个实例独享 * ,执行顺序为:
单个实例独享请求 * -> 所有实例共享请求 * -> 所有实例共享响应 * -> 单个实例独享响应 *
🌏单个方法独享 * (单个实例独享 * 位于所有实例共享 * 之前) ,执行顺序为:
单个方法请求 * -> 实例共享请求 * -> 单个独享请求 * -> 单个独享响应 * -> 实例共享响应 * -> 单个方法响应 *
请求拦截:constructor先执行的代码(use()), * 里面的回调hook后被执行,反之,先被执行
响应拦截:constructor先执行的代码(use()), * 里面的回调hook先被执行,反之,后被执行
需要修改执行顺序可调整代码的执行顺序
操作场景控制
由于存在三种 * ,存在一些复杂的操作场景时,比如,通过给所有实例或者单独实例提前添加了操作loading、错误捕获...,但是现在需要在某个请求方法中不进行此操作时,如何解决?
解决方案:通过继续扩展特定的 IHttpRequestConfig 类型属性,因为单个方法请求 * 是最先执行的,IHttpRequestConfig 配置项,在所有的 * 中是共享的,层级传递的,在 * 中判断特定的属性值关闭不需要的操作
来源:https://juejin.cn/post/7146927935885148191
猜你喜欢
- 总所周知bilibili是没有办法直接查看弹幕的发送者的
- 我们来学习一下 Python 中的加密模块,加密模块在工作中被广泛应用。比如数据的传入 不希望被捕获,通过把数据加密。这样即使被捕获也无法获
- 引言最近在技术交流群里聊到一个关于图像文字识别的需求,在工作、生活中常常会用到,比如票据、漫画、扫描件、照片的文本提取。博主基于 PyQt
- 前言Github源码地址本文同时也是学习唐宇迪老师深度学习课程的一些理解与记录。文中代码是实现在TensorFlow下使用卷积神经网络(CN
- 写在前面原计划继续写一篇Portia的使用博客,结果在编写代码途中发现,在windows7的DockerToolbox里面使用Portia错
- 有时候我们需要判断两个字符串内容是否相等,判断内容相等,我们用‘==',但是有时候发现print(str1)和print(str2)
- 同一台服务器上部署多个项目时,项目可能使用不同版本的django或者其它不同的python库,这种情况下可以使用virtualenv来创建独
- 1. 创建用户模块应用创建应用users$ python manage.py startapp users 2. 注册用户模块应用
- MySQL用户和权限在MySQL中有一个系统自身就带有的数据库叫MySQL,数据库装好以后系统自带了好几个数据库MySQL就是其中过一个,M
- 最近,想在我的YouMoney(http://code.google.com/p/youmoney/)里面增加提取用户操作系统版本信息。比如
- Facebook的网站速度做为最关键的公司任务之一。在2009年,我们成功地实现了Facebook网站速度提升两倍 。而正是我们的工程师团队
- Python处理json字符串中的非法双引号工作中数据清洗时遇到以下情况:a = '{"地区": "湖
- 安装anaconda后查询CPU版本时打开Anaconda Prompt输入python然后输入import tensorflow as t
- 创建:list = [5,7,9]取值和改值:list[1] = list[1] * 5列表尾插入:list.append(4)去掉第0个值
- 前言最近在搞 Python 课程设计,想要搞一个好看的 UI,惊艳全班所有人。但打开 Qt Creator,Win7 风格的复古的按钮是在让
- 本例程使用urlib实现的,基于python2.7版本,采用beautifulsoup进行网页分析,没有第三方库的应该安装上之后才能运行,我
- 一:创建迁移在laravel中使用make:migration命令来创建迁移php artisan make:migration creat
- 1 修改默认目录最近刚刚开始学习Python,比较好的一个IDE就是jupyter Notebook。可以一个cell一个cell的显示结果
- 可以通过遍历的方法:pandas按行按列遍历Dataframe的几种方式:https://www.jb51.net/article/1726
- 超酷的js图片轮换/轮播 渐变效果··来自腾讯刚刚在腾讯女性频道上看到一个很酷的图片渐变轮换效果·····于是乎····抠下来了···分享·