uni.request(OBJECT)

						
<script>
  export default {
    onLaunch: function() {
      uni.request({
        url: 'https://',
        data: {

        },
        success: (res)=> {
          if(res.statusCode == 200) {
            
          }
        }
      })
    }
  }
</script>
						
					

OBJECT 参数说明

OBJECT 参数说明
参数名类型必填默认值说明平台差异说明
urlString项目服务器接口地址。
dataObject/String/Array/Buffer请求的参数。App(自定义组件编译模式)不支持ArrayBuffer类型。
headerObject请求的 header。header 中不能设置 Referer。App、H5 端会自动带上 cookie,且 H5 端不可手动修改。
methodStringGET
timeoutNumber60000超时时间,单位 ms。H5(HBuilderX 2.9.9+)、APP(HBuilderX 2.9.9+)、微信小程序(2.10.0)、支付宝小程序
dataTypeStringjson如果设为 json,会尝试对返回的数据做一次 JSON.parse
responseTypeStringtext设置响应的数据类型。合法值:text、arraybuffer。App 和支付宝小程序不支持。
sslVerifyBooleantrue验证 ssl 证书。仅 App 安卓端支持(HBuilderX 2.3.3+)。
withCredentialsBooleanfalse跨域请求时是否携带凭证(cookies)。仅 H5 支持(HBuilderX 2.6.15+)。
firstIpv4BooleanfalseDNS 解析时优先使用 ipv4。仅 App-Android 支持(HBuilderX 2.8.0+)。
successFunction收到项目服务器成功返回的回调函数。
failFunction接口调用失败的回调函数。
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)。

method 有效值说明:

method 有效值
methodAppH5微信小程序支付宝小程序百度小程序字节跳动小程序
GET支持支持支持支持支持支持
POST支持支持支持支持支持支持
PUT支持支持支持不支持支持支持
DELETE支持支持支持不支持支持不支持
CONNECT不支持支持支持不支持不支持不支持
HEAD不支持支持支持不支持支持不支持
OPTIONS支持支持支持不支持支持不支持
TRACE不支持支持支持不支持不支持不支持

说明:

  • 必须大写,有效值在不同平台差异说明不同。

success 返回参数说明:

success 返回参数说明
参数类型说明
dataObject
String
ArrayBuffer
项目服务器返回的数据。
statusCodeNumber项目服务器返回的 HTTP 状态码。
headerObject项目服务器返回的 HTTP Response Header。
cookiesArray.<string>项目服务器返回的 cookies,格式为字符串数组。

说明:

  • 最终发送给服务器的数据是 String 类型,如果传入的 data 不是 String 类型,会被转换成 String。转换规则如下:
    • 对于 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。