提交 dcd54cc8 编写于 作者: DCloud-WZF's avatar DCloud-WZF 💬

feat(request): update options

上级 b5d271d0
......@@ -9,7 +9,7 @@
|:-|:-|:-|:-|:-|:-|
|url|String|是||开发者服务器接口地址||
|data|Object/String/ArrayBuffer|否||请求的参数|App 3.3.7 以下不支持 ArrayBuffer 类型|
|header|Object|否||设置请求的 header,header 中不能设置 Referer|App、H5端会自动带上cookie,且H5端不可手动修改|
|header|Object|否||设置请求的 header,header 中不能设置 Referer|App、H5端会自动带上cookie,且H5端不可手动修改|
|method|String|否|GET|有效值详见下方说明||
|timeout|Number|否|60000|超时时间,单位 ms|H5(HBuilderX 2.9.9+)、APP(HBuilderX 2.9.9+)、微信小程序(2.10.0)、支付宝小程序|
|dataType|String|否|json |如果设为 json,会尝试对返回的数据做一次 JSON.parse||
......@@ -17,6 +17,16 @@
|sslVerify|Boolean|否|true|验证 ssl 证书|仅App安卓端支持(HBuilderX 2.3.3+),不支持离线打包|
|withCredentials|Boolean|否|false|跨域请求时是否携带凭证(cookies)|仅H5支持(HBuilderX 2.6.15+)|
|firstIpv4|Boolean|否|false|DNS解析时优先使用ipv4|仅 App-Android 支持 (HBuilderX 2.8.0+)|
|enableHttp2|Boolean|否|false|开启 http2|微信小程序|
|enableQuic|Boolean|否|false|开启 quic|微信小程序|
|enableCache|Boolean|否|false|开启 cache|微信小程序、字节跳动小程序 2.31.0+|
|enableHttpDNS|Boolean|否|false|是否开启 HttpDNS 服务。如开启,需要同时填入 httpDNSServiceId 。 HttpDNS 用法详见 [移动解析HttpDNS](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/HTTPDNS.html)|微信小程序|
|httpDNSServiceId|String|否||HttpDNS 服务商 Id。 HttpDNS 用法详见 [移动解析HttpDNS](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/HTTPDNS.html)|微信小程序|
|enableChunked|Boolean|否|false|开启 transfer-encoding chunked|微信小程序|
|forceCellularNetwork|Boolean|否|false|wifi下使用移动网络发送请求|微信小程序|
|enableCookie|Boolean|否|false|开启后可在headers中编辑cookie|支付宝小程序 10.2.33+|
|cloudCache|Object/Boolean|否|false|是否开启云加速(详见[云加速服务](https://smartprogram.baidu.com/docs/develop/extended/component-codeless/cloud-speed/introduction/))|百度小程序 3.310.11+|
|defer|Boolean|否|false|控制当前请求是否延时至首屏内容渲染后发送|百度小程序 3.310.11+|
|success|Function|否||收到开发者服务器成功返回的回调函数||
|fail|Function|否||接口调用失败的回调函数||
|complete|Function|否||接口调用结束的回调函数(调用成功、失败都会执行)| |
......@@ -51,7 +61,7 @@
- 对于 ``GET`` 方法,会将数据转换为 query string。例如 ``{ name: 'name', age: 18 }`` 转换后的结果是 ``name=name&age=18``
- 对于 ``POST`` 方法且 ``header['content-type']````application/json`` 的数据,会进行 JSON 序列化。
- 对于 ``POST`` 方法且 ``header['content-type']````application/x-www-form-urlencoded`` 的数据,会将数据转换为 query string。
- 对于 ``POST`` 方法且 ``header['content-type']````application/x-www-form-urlencoded`` 的数据,会将数据转换为 query string。
**示例**
......@@ -164,7 +174,7 @@ https 请求配置自签名证书
**证书格式说明**
1. 文件路径形式:可将证书文件放到工程的 ‘static’ 目录中,然后填写文件路径,示例:`'/static/client.p12'`
2. `Base64String`:将证书文件的二进制转换为 `Base64String` 字符串,然后在字符串前面添加`'data:cert/pem;base64,'`前缀,示例:`'data:cert/pem;base64,xxx'` xxx 代表真实的证书 base64String
2. `Base64String`:将证书文件的二进制转换为 `Base64String` 字符串,然后在字符串前面添加`'data:cert/pem;base64,'`前缀,示例:`'data:cert/pem;base64,xxx'` xxx 代表真实的证书 base64String
**callbackObject 参数说明**
......@@ -184,4 +194,3 @@ uni.configMTLS({
success ({code}) {}
});
```
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册