【2025年1月2日】关于腾讯云小程序平台更名为腾讯云超级应用服务的公告
控制台更新动态
Android SDK 更新动态
iOS SDK 更新动态
Flutter 更新动态
IDE 更新动态
基础库更新动态
属性 | 类型 | 默认值 | 必填 | 说明 |
url | string | - | 是 | 开发者服务器接口地址 |
data | string/object/ArrayBuffer | - | 否 | 请求的参数 |
header | Object | - | 否 | 设置请求的 header，header 中不能设置 Referer。content-type 默认为 application/json |
timeout | number | - | 否 | 超时时间，单位为毫秒 |
method | string | GET | 否 | HTTP 请求方法 |
dataType | string | json | 否 | 返回的数据格式 |
responseType | string | text | 否 | 响应的数据类型 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
值 | 说明 |
OPTIONS | HTTP 请求 OPTIONS |
GET | HTTP 请求 GET |
HEAD | HTTP 请求 HEAD |
POST | HTTP 请求 POST |
PUT | HTTP 请求 PUT |
DELETE | HTTP 请求 DELETE |
TRACE | HTTP 请求 TRACE |
CONNECT | HTTP 请求 CONNECT |
值 | 说明 |
json | 返回的数据为 JSON，返回后会对返回的数据进行一次 JSON.parse |
其他 | 不对返回的内容进行 JSON.parse |
值 | 说明 |
text | 响应的数据为文本 |
arraybuffer | 响应的数据为 ArrayBuffer |
属性 | 类型 | 说明 |
data | string/Object/Arraybuffer | 开发者服务器返回的数据 |
statusCode | number | 开发者服务器返回的 HTTP 状态码 |
header | Object | 开发者服务器返回的 HTTP Response Header |
cookies | Array.<string> | 开发者服务器返回的 cookies，格式为字符串数组（小游戏暂未支持） |
属性 | 类型 | 说明 |
errMsg | 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)...）wx.request({url: 'test.php', // 仅为示例，并非真实的接口地址data: {x: '',y: ''},header: {'content-type': 'application/json' // 默认值},success(res) {console.log(res.data)}})
该方法使用方式为 RequestTask.abort()
该方法使用方式为 RequestTask.onChunkReceived(function listener)
属性 | 类型 | 说明 |
res | Object | 开发者服务器每次返回新 chunk 时的 Response |
结构属性 | 类型 | 说明 |
data | ArrayBuffer | 返回的 chunk buffer |
该 方法 使用方式为 RequestTask.offChunkReceived(function listener)
const listener = function (res) { console.log(res) }RequestTask.onChunkReceived(listener)RequestTask.offChunkReceived(listener) // 需传入与监听时同一个的函数对象
该 方法 使用方式为 RequestTask.onHeadersReceived(function listener)
属性 | 类型 | 说明 |
header | Object | 开发者服务器返回的 HTTP Response Header |
statusCode | Number | 开发者服务器返回的 HTTP 状态码 （目前开发者工具上不会返回 statusCode 字段，可用真机查看该字段，后续将会支持） |
cookies | Array.<string> | 开发者服务器返回的 cookies，格式为字符串数组 |
该 方法 使用方式为 RequestTask.offHeadersReceived(function listener)
const listener = function (res) { console.log(res) }RequestTask.onHeadersReceived(listener)RequestTask.offHeadersReceived(listener) // 需传入与监听时同一个的函数对象
文档反馈