uni-app发起网络请求

小鱼儿 2023-07-18 12:39 15阅读 0赞

## uni.request(OBJECT) ##

发起网络请求  
**OBJECT 参数说明**

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>类型</th> 
   <th>必填</th> 
   <th>默认值</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>url</td> 
   <td>string</td> 
   <td>是</td> 
   <td></td> 
   <td>开发者服务器接口地址</td> 
  </tr> 
  <tr> 
   <td>data</td> 
   <td>Object/String/ArrayBuffer</td> 
   <td>否</td> 
   <td></td> 
   <td>请求的参数</td> 
  </tr> 
  <tr> 
   <td>header</td> 
   <td>Object</td> 
   <td>否</td> 
   <td></td> 
   <td>设置请求的 header，header 中不能设置 Referer。</td> 
  </tr> 
  <tr> 
   <td>method</td> 
   <td>string</td> 
   <td>否</td> 
   <td>GET</td> 
   <td>（需大写）有效值：OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT</td> 
  </tr> 
  <tr> 
   <td>dataType</td> 
   <td>string</td> 
   <td>否</td> 
   <td>json</td> 
   <td>如果设为 json，会尝试对返回的数据做一次 JSON.parse</td> 
  </tr> 
  <tr> 
   <td>responseType</td> 
   <td>string</td> 
   <td>否</td> 
   <td>text</td> 
   <td>设置响应的数据类型。合法值：text、arraybuffer</td> 
  </tr> 
  <tr> 
   <td>success</td> 
   <td>Function</td> 
   <td>否</td> 
   <td></td> 
   <td>收到开发者服务成功返回的回调函数</td> 
  </tr> 
  <tr> 
   <td>fail</td> 
   <td>Function</td> 
   <td>否</td> 
   <td></td> 
   <td>接口调用失败的回调函数</td> 
  </tr> 
  <tr> 
   <td>complete</td> 
   <td>Function</td> 
   <td>否</td> 
   <td></td> 
   <td>接口调用结束的回调函数（调用成功、失败都会执行）</td> 
  </tr> 
 </tbody> 
</table>

**success 返回参数说明**

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>类型</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>data</td> 
   <td>Object/String/ArrayBuffer</td> 
   <td>开发者服务器返回的数据</td> 
  </tr> 
  <tr> 
   <td>statusCode</td> 
   <td>Number</td> 
   <td>开发者服务器返回的 HTTP 状态码</td> 
  </tr> 
  <tr> 
   <td>header</td> 
   <td>Object</td> 
   <td>开发者服务器返回的 HTTP Response Header</td> 
  </tr> 
 </tbody> 
</table>

**data 数据说明**

最终发送给服务器的数据是 `String` 类型，如果传入的 data 不是 String 类型，会被转换成 String。转换规则如下：

*  对于 `GET` 方法，会将数据转换为 `query string`。例如 `{ name: 'name', age: 18 }` 转换后的结果是  
    `name=name&age=18`。
 *  对于 `POST` 方法且 `header['content-type']` 为 `application/json` 的数据，会进行 `JSON`  
    序列化。

**例如：**

uni.request({ 
        url: 'https://...', 
        data: { 
            name: 'name',
            age: 18
        },
        header: { 
            'cus-header': 'hello' //自定义请求头信息
        },
        success: function (res) { 
            console.log(res.data);//输出
        }
    });

**返回值**

返回一个 requestTask 对象，通过 requestTask，可中断请求任务。

**requestTask 对象的方法列表**

<table> 
 <thead> 
  <tr> 
   <th>方法</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>abort</td> 
   <td>中断请求任务</td> 
  </tr> 
 </tbody> 
</table>

**例如：**