# mt.request(Object object)
发起 HTTPS 网络请求。
# 支持情况
| 项 | 说明 |
|---|---|
| 兼容性 | 部分兼容 |
# 参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| url | string | — | 是 | 请求 URL |
| data | string / Object / ArrayBuffer | — | 否 | 请求参数 |
| header | Object | — | 否 | 请求头,Referer 不可设置 |
| method | string | GET | 否 | HTTP 方法:GET / POST / PUT / DELETE / HEAD / OPTIONS / TRACE / CONNECT |
| dataType | string | json | 否 | 返回数据格式;json 时自动对返回数据做 JSON 解析 |
| responseType | string | text | 否 | 响应数据类型:text / arraybuffer |
| timeout | number | 20000 | 否 | 超时时间,单位 ms |
| success | function | — | 否 | 成功回调 |
| fail | function | — | 否 | 失败回调 |
| complete | function | — | 否 | 完成回调(成功或失败均触发) |
success 回调参数
| 属性 | 类型 | 说明 |
|---|---|---|
| data | string / Object / ArrayBuffer | 响应数据 |
| statusCode | number | HTTP 状态码 |
| header | Object | 响应头 |
| cookies | Array | 开发者服务器返回的 cookies |
# 返回值
返回 RequestTask 对象。
# 注意事项
- 最大并发请求数为 12,超出后排队等待。
- 请求 URL 包含
mgc.meituan.com时,会自动在请求参数中注入美团公共参数(如设备指纹、会话信息等);URL 参数中已有同名字段时,以 URL 中的值为准,公共参数中对应字段会被丢弃。
# 示例代码
const task = mt.request({
url: 'https://example.com/api',
method: 'POST',
header: { 'content-type': 'application/json' },
data: { key: 'value' },
success(res) {
console.log(res.statusCode)
console.log(res.data)
},
fail(err) {
console.error(err.errMsg)
}
})
// 可中断请求
task.abort()
# 与微信差异
- 对
mgc.meituan.com域名自动注入公共参数(微信无此行为)。 - success 回调不返回
profile字段(微信用此字段提供 DNS 解析、TCP 建立等网络性能数据)。 timeout默认值为20000ms;微信默认值为60000ms。- 不支持微信的
enableHttp2、enableQuic、enableHttpDNS、httpDNSServiceId、enableCache、enableChunked、forceCellularNetwork、useHighPerformanceMode、enableProfile、defer等高级网络参数。