stream

stream

概述

以下为 stream 相关的 API,用于实现网络请求。

API

fetch(options, callback[progressCallback])

发起网络请求

参数

  • options {Object}:请求的一些选项

    • method {string}:HTTP 方法 GET 或是 POST
    • url {string}:请求的 URL
    • headers {Object}:HTTP 请求头
    • type {string}:响应类型, jsontext 或是 jsonp (在原生实现中其实与 json 相同)
    • body {string}:HTTP 请求体

      注意:

      • body 参数仅支持 string 类型的参数,请勿直接传递 JSON,必须先将其转为字符串。
      • GET 请求不支持 body 方式传递参数,请使用 url 传参。
  • callback {Function}:响应结果回调,回调函数将收到如下的 response 对象:

    • status {number}:返回的状态码
    • ok {boolean}:如果状态码在 200~299 之间就为真。
    • statusText {string}:状态描述文本
    • data {Object | string}:返回的数据,如果请求类型是 jsonjsonp,则它就是一个 object ,如果不是,则它就是一个 string。
    • headers {Object}:响应头
  • progressCallback {Function}:关于请求状态的回调。 这个回调函数将在请求完成后就被调用:

    • readyState {number}:当前状态
      state:‘1’: 请求连接中
      opened:‘2’: 返回响应中
      received:‘3’: 正在加载返回数据
    • status {number}:响应状态码
    • length {number}:已经接受到的数据长度,你可以从响应头中获取总长度
    • statusText {string}:状态文本
    • headers {Object}:响应头

基本用法

const modal = light.requireModule('modal')
const stream = weex.requireModule('stream')
const body = JSON.stringify({title, article});

stream.fetch({
method: 'POST',
url: url,
type:'json',
body: body
}, function(ret) {

if(!ret.ok){
modal.toast({
message: 'Network Error!',
duration: 3
});
}else{
modal.toast({
message: '提交成功!' + body,
duration: 3
});
}
})

注意

  • 默认 Content-Type 是 ‘application/x-www-form-urlencoded’。
  • 如果你需要通过 POST json,需要将 Content-Type 设为 ‘application/json’。