import { combineURL } from '../helpers/combineURL'; import { isString } from '../helpers/isTypes'; import { dispatchRequest } from '../request/dispatchRequest'; import { CancelToken } from '../request/cancel'; import { AxiosTransformer } from '../request/transformData'; import { deepMerge } from '../helpers/deepMerge'; import { AxiosAdapter, AxiosAdapterRequestMethod, AxiosAdapterPlatformTask, AxiosAdapterRequestConfig, AxiosAdapterResponseData, } from '../adpater/createAdapter'; import InterceptorManager, { Interceptor, InterceptorExecutor, } from './InterceptorManager'; import { mergeConfig } from './mergeConfig'; import { PLAIN_METHODS, WITH_DATA_METHODS, WITH_PARAMS_METHODS, } from '../constants/methods'; import MiddlewareManager from './MiddlewareManager'; /** * 请求方法 */ export type AxiosRequestMethod = | AxiosAdapterRequestMethod | 'options' | 'get' | 'head' | 'post' | 'put' | 'patch' | 'delete' | 'trace' | 'connect'; /** * 请求头 */ export interface AxiosRequestHeaders extends AnyObject { /** * 通用请求头 */ common?: AnyObject; /** * options 请求头 */ options?: AnyObject; /** * get 请求头 */ get?: AnyObject; /** * head 请求头 */ head?: AnyObject; /** * post 请求头 */ post?: AnyObject; /** * put 请求头 */ put?: AnyObject; /** * delete 请求头 */ delete?: AnyObject; /** * trace 请求头 */ trace?: AnyObject; /** * connect 请求头 */ connect?: AnyObject; } /** * 表单数据(上传会用到) */ export interface AxiosRequestFormData extends AnyObject { /** * 文件名 */ name: string; /** * 文件路径 */ filePath: string; } /** * 请求数据 */ export type AxiosRequestData = | string | AnyObject | ArrayBuffer | AxiosRequestFormData; /** * 响应数据 */ export type AxiosResponseData = number | AxiosAdapterResponseData; /** * 进度对象 */ export interface AxiosProgressEvent extends AnyObject { /** * 上传进度百分比 */ progress: number; } /** * 下载进度对象 */ export interface AxiosDownloadProgressEvent extends AxiosProgressEvent { /** * 已经下载的数据长度,单位 Bytes */ totalBytesWritten: number; /** * 预预期需要下载的数据总长度,单位 Bytes */ totalBytesExpectedToWrite: number; } /** * 监听下载进度 */ export interface AxiosDownloadProgressCallback { (event: AxiosDownloadProgressEvent): void; } /** * 上传进度对象 */ export interface AxiosUploadProgressEvent extends AxiosProgressEvent { /** * 已经上传的数据长度,单位 Bytes */ totalBytesSent: number; /** * 预期需要上传的数据总长度,单位 Bytes */ totalBytesExpectedToSend: number; } /** * 监听上传进度 */ export interface AxiosUploadProgressCallback { (event: AxiosUploadProgressEvent): void; } /** * 请求配置 */ export interface AxiosRequestConfig extends Partial< Omit > { /** * 请求适配器 */ adapter?: AxiosAdapter; /** * 基础路径 */ baseURL?: string; /** * 请求的 URL */ url?: string; /** * 请求参数 */ params?: AnyObject; /** * 请求数据 */ data?: AxiosRequestData; /** * 请求头 */ headers?: AxiosRequestHeaders; /** * 请求方法 */ method?: AxiosRequestMethod; /** * 取消令牌 */ cancelToken?: CancelToken; /** * 下载文件 */ download?: boolean; /** * 上传文件 */ upload?: boolean; /** * 请求参数系列化函数 */ paramsSerializer?: (params?: AnyObject) => string; /** * 校验状态码 */ validateStatus?: (status: number) => boolean; /** * 转换请求数据 */ transformRequest?: AxiosTransformer; /** * 转换响应数据 */ transformResponse?: AxiosTransformer; /** * 错误处理 */ errorHandler?: (error: unknown) => Promise; /** * 监听下载进度 */ onDownloadProgress?: AxiosUploadProgressCallback; /** * 监听上传进度 */ onUploadProgress?: AxiosUploadProgressCallback; } /** * 响应体 */ export interface AxiosResponse< TData extends AxiosResponseData = AxiosResponseData, > extends AnyObject { /** * 状态码 */ status: number; /** * 状态字符 */ statusText: string; /** * 响应头 */ headers: AnyObject; /** * 响应数据 */ data: TData; /** * 请求配置 */ config: AxiosRequestConfig; /** * 请求任务 */ request?: AxiosAdapterPlatformTask; } /** * 错误体 */ export interface AxiosResponseError extends AnyObject { /** * 状态码 */ status: number; /** * 状态字符 */ statusText: string; /** * 响应头 */ headers: AnyObject; /** * 错误数据 */ data: AnyObject; /** * 失败的请求,指没能够成功响应的请求 */ isFail: true; /** * 请求配置 */ config: AxiosRequestConfig; /** * 请求任务 */ request?: AxiosAdapterPlatformTask; } export interface AxiosContext { req: AxiosRequestConfig; res: null | AxiosResponse; } export interface AxiosRequest { (config: AxiosRequestConfig): Promise< AxiosResponse >; ( url: string, config?: AxiosRequestConfig, ): Promise>; } /** * 普通的请求方法 */ export type AxiosRequestMethodFn = ( url: string, config?: AxiosRequestConfig, ) => Promise>; /** * 带参数的请求方法 */ export type AxiosRequestMethodFnWithParams = ( url: string, params?: AnyObject, config?: AxiosRequestConfig, ) => Promise>; /** * 带数据的请求方法 */ export type AxiosRequestMethodFnWithData = ( url: string, data?: AxiosRequestData, config?: AxiosRequestConfig, ) => Promise>; export interface AxiosDomainRequestHandler { (config: AxiosRequestConfig): Promise; } /** * Axios 构造函数 */ export interface AxiosConstructor { new (config: AxiosRequestConfig): Axios; } export default class Axios { #parent?: Axios; /** * 默认请求配置 */ defaults: AxiosRequestConfig; /** * 拦截器 */ interceptors = { /** * 请求拦截器 */ request: new InterceptorManager(), /** * 响应拦截器 */ response: new InterceptorManager(), }; /** * 中间件 */ #middleware = new MiddlewareManager(async (ctx) => { ctx.res = await dispatchRequest(ctx.req); }); /** * 发送 options 请求 */ options!: AxiosRequestMethodFn; /** * 发送 get 请求 */ get!: AxiosRequestMethodFnWithParams; /** * 发送 head 请求 */ head!: AxiosRequestMethodFnWithParams; /** * 发送 post 请求 */ post!: AxiosRequestMethodFnWithData; /** * 发送 put 请求 */ put!: AxiosRequestMethodFnWithData; /** * 发送 patch 请求 */ patch!: AxiosRequestMethodFnWithData; /** * 发送 delete 请求 */ delete!: AxiosRequestMethodFnWithParams; /** * 发送 trace 请求 */ trace!: AxiosRequestMethodFn; /** * 发送 connect 请求 */ connect!: AxiosRequestMethodFn; /** * 添加中间件 */ use: MiddlewareManager['use']; constructor(defaults: AxiosRequestConfig = {}, parent?: Axios) { this.defaults = defaults; this.#parent = parent; if (this.#parent) { this.#middleware.flush = this.#parent.#middleware.wrap( this.#middleware.flush, ); } this.use = this.#middleware.use.bind(this.#middleware); } /** * 发送请求 */ request: AxiosRequest = ( urlOrConfig: string | AxiosRequestConfig, config: AxiosRequestConfig = {}, ) => { if (isString(urlOrConfig)) { config.url = urlOrConfig; } else { config = urlOrConfig; } config.method = config.method || 'get'; return this.#processRequest(mergeConfig(this.defaults, config)); }; #processRequest(config: AxiosRequestConfig) { const requestHandler = { resolved: async (config: AxiosRequestConfig) => { config.url = combineURL(config.baseURL, config.url); const ctx: AxiosContext = { req: config, res: null, }; await this.#middleware.flush(ctx); return ctx.res as AxiosResponse; }, }; const errorHandler = { rejected: config.errorHandler, }; const chain: ( | Partial> | Partial> )[] = []; this.#eacheRequestInterceptors((requestInterceptor) => { chain.unshift(requestInterceptor); }); chain.push(requestHandler); this.#eacheResponseInterceptors((responseInterceptor) => { chain.push(responseInterceptor); }); chain.push(errorHandler); return chain.reduce( (next, { resolved, rejected }) => next.then( // @ts-ignore resolved, rejected, ), Promise.resolve(config), ) as Promise; } #eacheRequestInterceptors(executor: InterceptorExecutor) { this.interceptors.request.forEach(executor); if (this.#parent) { this.#parent.#eacheRequestInterceptors(executor); } } #eacheResponseInterceptors(executor: InterceptorExecutor) { this.interceptors.response.forEach(executor); if (this.#parent) { this.#parent.#eacheResponseInterceptors(executor); } } } for (const method of PLAIN_METHODS) { Axios.prototype[method] = function processRequestMethod(url, config = {}) { config.method = method; return this.request(url, config); }; } for (const method of WITH_PARAMS_METHODS) { Axios.prototype[method] = function processRequestMethodWithParams( url, params = {}, config = {}, ) { config.method = method; config.params = deepMerge(params, config.params ?? {}); return this.request(url, config); }; } for (const method of WITH_DATA_METHODS) { Axios.prototype[method] = function processRequestMethodWithData( url, data, config = {}, ) { config.method = method; config.data = data; return this.request(url, config); }; }