RequestTask mc.request(Object object)
发起 HTTPS 网络请求。
| 属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
| url | String | | 是 | 开发者服务器接口地址 | |
| data | String/Object/ArrayBuffer | | 否 | 请求的参数 | |
| header | Object | | 否 | 设置请求的 header。 content-type 默认为 application/json | |
| timeout | Number | | 否 | 超时时间,单位为毫秒 | |
| method | String | GET | 否 | HTTP 请求方法 | |
| dataType | String | json | 否 | 返回的数据格式 json 会对返回的数据进行一次 JSON.parse | |
| responseType | String | text | 否 | 响应的数据类型 | |
| success | Function | | 否 | 接口调用成功的回调函数 | |
| fail | Function | | 否 | 接口调用失败的回调函数 | |
| complete | Function | | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | |
注意:最终发送给服务器的数据是 String 类型,如果传入的 data 不是 String 类型,会被转换成 String 。转换规则如下:
- 对于
GET 方法的数据,会将数据转换成 query string(encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)...)
- 对于
POST 方法且 header['content-type'] 为 application/json 的数据,会对数据进行 JSON 序列化
- 对于
POST 方法且 header['content-type'] 为 application/x-www-form-urlencoded 的数据,会将数据转换成 query string (encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)...)
Object.method 的合法值
| 值 | 说明 | 最低版本 |
| OPTIONS | HTTP 请求 OPTIONS | |
| GET | HTTP 请求 GET | |
| HEAD | HTTP 请求 HEAD | |
| POST | HTTP 请求 POST | |
| PUT | HTTP 请求 PUT | |
| DELETE | HTTP 请求 DELETE | |
| TRACE | HTTP 请求 TRACE | |
| CONNECT | HTTP 请求 CONNECT | |
Object.responseType 的合法值
| 值 | 说明 | 最低版本 |
| text | 响应的数据为文本 | |
| Arraybuffer | 响应的数据为 ArrayBuffer | |
| 属性 | 类型 | 说明 | 最低版本 |
| data | String/Object/Arraybuffer | 开发者服务器返回的数据 | |
| statusCode | Number | 开发者服务器返回的 HTTP 状态码 | |
| header | Object | 开发者服务器返回的 HTTP Response Header | |
| cookies | [String] | 开发者服务器返回的 cookies,格式为字符串数组 | |
| profile | Object | 网络请求过程中一些调试信息 | |
请求任务对象
示例代码:
mc.request({
url: 'https://test.com',
data: {
user: 'test',
pwd: 'pwd'
},
method: 'POST',
success: function (e) {
console.log(e.data);
}
})