配置
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
baseURL | String | "" | 基础 URL |
url | String | "" | 请求 URL |
params | Object | {} | 请求参数,会合并到 url 中 |
data | Object | {} | 请求参数,会合并到 body 中 |
headers | Object | {} | 请求头参数 |
method | String | "GET" | 请求方法。GET、POST、PUT、DELETE、CONNECT、HEAD、OPTIONS、TRACE、UPLOAD |
timeout | Number | 30000 | 请求超时时间,单位毫秒 |
dataType | String | json | 如果设为 json, 会对返回的数据进行一次 JSON.parse, 非 json 不会进行 JSON.parse |
responseType | String | text | 设置响应的数据类型,text 、 arraybuffer |
sslVerify | Boolean | true | 是否验证 SSL 证书 |
withCredentials | Boolean | false | 跨域请求时是否携带凭证(cookies) |
firstIpv4 | Boolean | false | 跨域请求时是否优先使用 IPv4 地址 |
enableHttp2 | Boolean | false | 是否开启 http2 |
enableQuic | Boolean | false | 是否开启 quic |
enableCache | Boolean | false | 是否开启 cache |
enableHttpDNS | Boolean | false | 是否开启 HttpDNS 服务 |
httpDNSServiceId | String | "" | HttpDNS 服务商 ID |
enableChunked | Boolean | false | 是否开启 transfer-encoding chunked |
forceCellularNetwork | Boolean | false | 是否在 wifi 下使用移动网络发送请求 |
enableCookie | Boolean | false | 开启后可在 headers 中编辑 cookie |
cloudCache | Boolean | false | 是否开启云加速 |
defer | Boolean | false | 控制当前请求是否延时至首屏内容渲染后发送 |
files | Array | null | 需要上传的文件列表。使用 files 时,filePath 和 name 不生效 |
fileType | String | image | 文件类型,image/video/audio |
filePath | String | null | 要上传的文件路径 |
name | String | file | 文件对应的 key , 开发者在服务器端通过这个 key 可以获取到文件二进制内容 |
formData | Object | {} | HTTP 请求中其他额外的 form data |
successStatusCode | Number | 200 | 表示 HTTP 请求成功的状态码 |
successStatusCode | [Number、Array、Object] | 200 | 详情 表示 HTTP 请求成功的状态码 |
successDataCode | [Number、Array、Object] | 0 | 详情 表示数据正常的状态码 |
before | Function | null | 详情 请求前的处理函数 |
after | Function | null | 详情 响应后的处理函数 |
loading | Boolean | true | 是否显示 loading |
loadingDelay | Number | 800 | 请求超过此值设置的毫秒数后才会显示 loading,设置为 0 会在请求后立即显示 loading |
loadingTips | String | "" | loading 提示内容 |
loadingMask | Boolean | true | 是否显示透明蒙层,防止触摸穿透 |
error | Boolean | true | 是否显示错误提示 |
errorTips | String | "" | 错误提示内容 |
errorMask | Boolean | true | 是否显示透明蒙层,防止触摸穿透 |
success | Boolean | false | 是否显示成功提示 |
successTips | String | "" | 成功提示内容 |
successMask | Boolean | true | 是否显示透明蒙层,防止触摸穿透 |
successStatusCode
表示 HTTP 请求成功的状态码。可以是数字,数组或对象。
- 数字:表示单个状态码,例如
200,只有状态码为200时才表示请求成功。 - 数组:表示多个状态码,例如
[200, 201],// 状态码为200,201中的任何一个时就表示请求成功。 - 对象:表示状态码范围,例如
{ start: 200, end: 300 },// 状态码为>=200且<300时就表示请求成功。
successDataCode
表示数据正常的状态码。可以是数字,数组或对象。
- 数字:表示单个状态码,例如
0,只有状态码为0时才表示数据正常。 - 数组:表示多个状态码,例如
[0, 1],// 状态码为0,1中的任何一个时就表示数据正常。 - 对象:表示状态码范围,例如
{ start: 0, end: 10 },// 状态码为>=0且<10时就表示数据正常。
before
表示请求前的处理函数。可以是同步函数或异步函数。如果返回 null 则中断请求。
after
表示响应后的处理函数。可以是同步函数或异步函数。如果返回 null 则表示继续处理响应。