tt.request

从基础库 1.0.0 开始支持,这是一个异步方法。

发起一个 HTTP 请求。网络相关的 API 在使用前需要配置域名白名单。请参考网络请求使用说明


参数

Object object

名称数据类型属性默认值描述
urlstringrequiredN/A请求地址
headerobjectoptional{'content-type': 'application/json'}请求 Header
methodstringoptionalGET请求方法
dataobject / string / arraybufferoptionalnull请求数据
dataTypestringoptionaljson请求数据类型
responseTypestringoptionaltext响应数据类型,参数值可以是textarraybuffer
successfunctionoptional接口调用成功后的回调函数
failfunctionoptional接口调用失败后的回调函数
completefunctionoptional接口调用结束后的回调函数(调用成功、失败都会执行)

object.method 的合法值

说明
GET
POST
OPTIONS
PUT
HEAD
DELETE

object.dataType 的合法值

说明
json返回的数据为 JSON,返回后会对返回的数据进行一次 JSON.parse
其他不对返回的内容进行 JSON.parse

object.responseType 的合法值

说明
text响应的数据为文本
arraybuffer响应的数据为 ArrayBuffer

object.success 回调函数

参数

Object res

名称数据类型描述
statusCodenumber返回 HTTP 状态码
headerobject返回 HTTP Header
dataobject / string / arraybuffer返回数据

返回值

RequestTask对象


代码示例

let task = tt.request({
  url: "someurl",
  data: {
    user_name: "hello"
  },
  header: {
    "content-type": "application/json"
  },
  success(res) {
    console.log(`request调用成功 ${res}`);
  },
  fail(res) {
    console.log(`request调用失败`);
  }
});

if (someReason) {
  task.abort();
}

Bug & Tip

  • header不支持设置referer
点击纠错