请求任务

接口声明

在manifest.json文件的 features属性中增加如下配置。

{"name": "system.requesttask"}

导入模块

在调用接口页面的<script>部分增加如下配置。

import requesttask from '@system.requesttask'

或

var requesttask = require("@system.requesttask")

使用限制

接口定义

requesttask.request(OBJECT) (1078+，非厂商联盟规范)

描述

创建一个网络请求，每次成功调用requesttask.request将返回一个新的RequestTask对象。

参数

data与Content-Type关系说明

success返回值

responseType与success中data关系说明

示例代码

this.request_task = requesttask.request({
    url: 'https://httpbin.org/anything',
    method:'POST',
    data:"12313213213212",
    success(res) {
        console.log("Request success. resp = " + JSON.stringify(res))
    },
    fail(res) {
        console.log("Request fail. resp = " + JSON.stringify(res))
    }
})

requestTask.onProgressUpdate(function callback) (1078+，非厂商联盟规范)

描述

监听请求进度变化事件。

只在post、put、connect方法下生效。

参数

请求进度变化事件的回调函数。

callback返回参数

Object类型。

示例代码

this.request_task.onProgressUpdate(res => {
    console.log("Request progress update = " + JSON.stringify(res))
})

requestTask.offProgressUpdate(function callback) (1078+，非厂商联盟规范)

描述

取消监听请求进度变化事件。

参数

请求进度变化事件的回调函数。

示例代码

this.request_task.offProgressUpdate()

requestTask.onHeadersReceived(function callback) (1078+，非厂商联盟规范)

描述

监听 HTTP Response Header 事件。在请求成功回调之前触发。

参数

HTTP Response Header 事件的回调函数。

callback返回参数

object类型。

示例代码

this.request_task.onHeadersReceived(res => {
    console.log("Request onHeaderReceived = " + JSON.stringify(res))
})

requestTask.offHeadersReceived(OBJECT) (1078+，非厂商联盟规范)

描述

取消监听 HTTP Response Header 事件。

参数

HTTP Response Header 事件的回调函数。

示例代码

this.request_task.offHeadersReceived()

requestTask.abort() (1078+，非厂商联盟规范)

描述

中断请求任务。

示例代码

this.request_task.abort()

安全要求

对于HTTPS请求，对证书要求如下：

• HTTPS证书必须有效。证书必须被系统信任，不支持自签名证书，部署SSL证书的网站域名必须与证书颁发的域名一致，证书必须在有效期内。
• 从1200版本开始，TLS必须支持1.2及以上版本，请确保HTTPS服务器的TLS版本能够同时支持TLS1.2及以下版本。

  从安全性考虑，建议也支持TLS1.3。1200及以上版本在配置加密套件时排除不安全算法：TEA/DES/DESX/DES40/RC2/RC4/RIPEMD/NULL/SHA0/MD2/MD4/MD5/ANON/TLS_EMPTY_RENEGOTIATION_INFO_SCSV；1200以下版本在配置加密套件时排除不安全算法：TEA/DES/DESX/DES40/RC2/RC4/RIPEMD/eNULL/aNULL/NULL/SHA0/MD2/MD4/MD5/ANON/TLS_EMPTY_RENEGOTIATION_INFO_SCSV。部分CA可能不被操作系统信任，请开发者在选择证书时注意操作系统的相关通告。