数据请求 requesttask 1100+

接口声明

{ "name": "system.requesttask" }

导入模块

import requesttask from '@system.requesttask' 或 const requesttask = require("@system.requesttask")

接口定义

方法

RequestTask requesttask.request(OBJECT)

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

参数：

success 返回值：

responseType 与 success 中 data 的关系：

RequestTask

网络请求任务对象

方法

RequestTask.abort()

中断请求任务

RequestTask.onHeadersReceived(callback)

监听 HTTP Response Header 事件，会比请求完成事件更早。

参数

callback 返回值

RequestTask.offHeadersReceived(callback)

取消监听 HTTP Response Header 事件。callback 是可选的，如果不传则取消所有通过 onHeadersReceived 监听的 HTTP Response Header 事件。

参数

示例代码：

const retRequestTask = requesttask.request({
  url: 'http://www.example.com',
  responseType: 'text',
  method: 'GET',
  success: function(res) {
    console.log(`the status code of the response: ${res.statusCode}`)
    console.log(`the data of the response: ${res.data}`)
    console.log(`the headers of the response: ${JSON.stringify(res.headers)}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, errMsg = ${data}`)
    console.log(`handling fail, errCode = ${code}`)
  }
})

// 中断请求任务
retRequestTask.abort()

// 监听响应头事件
retRequestTask.onHeadersReceived(header => {
  console.log(
    `listening for response header event, header = ${JSON.stringify(header)}`
  )
})

// 取消监听 HTTP Response Header 事件
retRequestTask.offHeadersReceived()

取消特定的 HTTP Response Header 事件

function cb(header) {
  console.log(
    `listening for response header event 1, header = ${JSON.stringify(header)}`
  )
}

// 此次监听会被取消
retRequestTask.onHeadersReceived(cb)

// event2 监听依然有效，不会被取消
retRequestTask.onHeadersReceived(header => {
  console.log(
    `listening for response header event 2, header = ${JSON.stringify(header)}`
  )
})

retRequestTask.offHeadersReceived(cb)

后台运行限制

无限制。 后台运行详细用法参见后台运行 脚本。