Uni-app网络请求---uni.request

uni.request(OBJECT)

发起网络请求。

OBJECT 参数说明

参数名 类型 必填 默认值 说明 平台差异说明
url String   开发者服务器接口地址  
data Object/String/ArrayBuffer   请求的参数 App(自定义组件编译模式)不支持ArrayBuffer类型
header Object   设置请求的 header,header 中不能设置 Referer。 H5端会自动带上cookie不可手动覆盖
method String GET 有效值详见下方说明  
timeout Number 30000 超时时间,单位 ms 微信小程序(2.10.0)、支付宝小程序
dataType String json 如果设为 json,会尝试对返回的数据做一次 JSON.parse  
responseType String text 设置响应的数据类型。合法值:text、arraybuffer App和支付宝小程序不支持
sslVerify Boolean true 验证 ssl 证书 仅App安卓端支持(HBuilderX 2.3.3+)
withCredentials Boolean false 跨域请求时是否携带凭证(cookies) 仅H5支持(HBuilderX 2.6.15+)
firstIpv4 Boolean false DNS解析时优先使用ipv4 仅 App-Android 支持 (HBuilderX 2.8.0+)
success Function   收到开发者服务器成功返回的回调函数  
fail Function   接口调用失败的回调函数  
complete Function   接口调用结束的回调函数(调用成功、失败都会执行)  

 

Uni-app网络请求---uni.request

 

 

success 返回参数说明

参数 类型 说明
data Object/String/ArrayBuffer 开发者服务器返回的数据
statusCode Number 开发者服务器返回的 HTTP 状态码
header Object 开发者服务器返回的 HTTP Response Header

data 数据说明

最终发送给服务器的数据是 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。

示例

uni.request({
    url: https://www.example.com/request, //仅为示例,并非真实接口地址。
    data: {
        text: uni.request
    },
    header: {
        custom-header: hello //自定义请求头信息
    },
    success: (res) => {
        console.log(res.data);
        this.text = request success;
    }
});

 

config: {
        baseUrl: "https://www.baidu.com/",
        header: {
            Content-Type: application/json;charset=UTF-8,
            Content-Type: application/x-www-form-urlencoded,
        },
        data: {},
        method: "GET",
        dataType: "json",
        /* 如设为json,会对返回的数据做一次 JSON.parse */
        responseType: "text",
        success() {},
        fail() {},
        complete() {}
    },

 

Uni-app网络请求---uni.request

上一篇:App自动化测试


下一篇:android view源码