Skip to content

方法参数说明

defHttp 类型定义

ts
declare const defHttp: (opt: CreateAxiosOptions) => VAxios;
方法名参数类型说明TypeScript 类型
useplugin: VAxiosPlugin注册插件方法public use(plugin: VAxiosPlugin): VAxios
destroy销毁 axios 实例public destroy(): void
getconfig: AxiosRequestConfig, options?: RequestOptionsGET 请求方法public get<T = any>(config: AxiosRequestConfig, options?: RequestOptions): Promise<T>
postconfig: AxiosRequestConfig, options?: RequestOptionsPOST 请求方法public post<T = any>(config: AxiosRequestConfig, options?: RequestOptions): Promise<T>
putconfig: AxiosRequestConfig, options?: RequestOptionsPUT 请求方法public put<T = any>(config: AxiosRequestConfig, options?: RequestOptions): Promise<T>
deleteconfig: AxiosRequestConfig, options?: RequestOptionsDELETE 请求方法public delete<T = any>(config: AxiosRequestConfig, options?: RequestOptions): Promise<T>
requestconfig: AxiosRequestConfig, options?: RequestOptions通用请求方法public request<T = any>(config: AxiosRequestConfig, options?: RequestOptions): Promise<T>

CreateAxiosOptions 参数说明

属性说明TypeScript 类型
authenticationScheme认证方案 URLstring 例如 headers传入authorization是这种Bearer token其中Bearer就是认证方案,默认是
timeout请求超时时间,默认10snumber
headers请求头 默认{ 'Content-Type': 'application/json;charset=UTF-8' }object
requestOptions默认请求配置requestOptions
其他支持的配置项axios request configobject

RequestOptions参数说明

属性说明TypeScript 类型
joinParamsToUrl将请求参数拼接到 URL,post请求的时候添加参数到url,默认falseboolean
formatDate格式化请求参数时间,默认trueboolean
isTransformResponse是否处理请求结果,默认trueboolean
isReturnNativeResponse是否返回原生响应头 比如:需要获取响应头时使用该属性 ,默认falseboolean
joinPrefix是否拼接 URL 前缀 ,urlPrefixurl是否拼接,默认trueboolean
apiUrl相当于baseUrl,例如http://api.demo.com ,默认行为会讲apiUrlurl拼接string
urlPrefix请求拼接路径,例如/api,如果joinPrefix等于true那么则urlPrefixurl拼接,string
errorMessageMode错误消息提示类型,默认modal'modal'|'notice'|'message'
successMessageMode成功消息提示类型,默认none'modal'|'notice'|'message'
getContainer指定Modal挂载的HTML节点,只针对errorMessageMode类型是modal,默认()=>document.body() => HTMLElement | null
zIndexModal弹窗层级 ,默认10000number
joinTime给 get 请求加上时间戳参数,避免从缓存中拿数据, ,默认trueboolean
ignoreCancelToken是否开启取消请求,单位时间内因为网络卡顿,多次请求,只有最后一次会被执行 ,默认falseboolean
withToken是否在 header 中发送 token ,默认trueboolean
customSuccessMessage自定义成功提示string
closeErrorModal是否关闭错误弹窗,默认falseboolean

ErrorResponse参数说明

WARNING

ErrorResponse 是请求出现错误的时候core包对外reject的一个对象,包含了请求错误详细信息,以下是参数说明

属性说明TypeScript 类型
url请求完整路径地址string
payload请求参数object
method请求方法GET/POST/PUT/DELETE
code错误码number
message服务器原始错误信息string
transactionMessage服务器错误事务信息string
resData请求返回值any
traceId请求追踪id,有助于排查服务端错误string