RequestTask mc.request(Object object)
发起 HTTPS 网络请求。
Object object 参数
属性 |
类型 |
默认值 |
必填 |
说明 |
最低版本 |
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 |
|
Object.success(Object res) 回调函数
属性 |
类型 |
说明 |
最低版本 |
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);
}
})