# stream

stream 模块提供了基本的网络请求能力,例如 GET 请求、POST 请求等,用于在组件的生命周期内与服务端进行交互。

# API

# fetch

发起一个请求。

# fetch(options, callback, progressCallback)

  • @options, 请求的配置选项,支持以下配置
    • method, string, HTTP 请求方法,值为 GET/POST/PUT/DELETE/PATCH/HEAD
    • url, string, 请求的 URL | string
    • headers, object, HTTP 请求头
    • type, string, 响应类型:jsontext 或是 jsonp(在 native 原生实现中其实与 json 相同)
    • body, string, HTTP 请求体

注意

  • body 参数仅支持 string 类型的参数,请勿直接传递 JSON,必须先将其转为字符串。
  • GET 请求不支持 body 方式传递参数,请使用 URL 传参。
  • 默认 Content-Typeapplication/x-www-form-urlencoded
  • 如果你需要通过 POST 发送 json 数据, 需要将 Content-Type 设为 application/json
  • @callback, 响应结果回调,回调函数将收到如下的 response 对象:

    • status, number, 返回的状态码
    • ok, boolean, 如果状态码在 200-299 之间就为 true
    • statusText, string, 状态描述文本
    • data, string, 返回的数据,如果请求类型是 jsonjsonp,则它就是一个 object ,否则是一个 string
    • headers, object, HTTP 响应头
  • @progressCallback, function, a progress callback. This callback will be invoked before request finished.

    • readyState, number, 当前状态,1: 请求连接中;2: 返回响应头中;3: 正在加载返回数据
    • status, number, 返回的状态码
    • length number, 已经接受到的数据长度. 你可以从响应头中获取总长度
    • statusText, string, 状态描述文本
    • headers. object, HTTP 响应头

TIP

  • 默认的 Content-Type 为 'application/x-www-form-urlencoded'. fetch 方法中设置的 type 是响应类型。
  • 如果要发送 JSON 数据,需要设置 Content-Type 为 'application/json'。

示例

上次更新: 2022/8/15
文档写得很棒文档写得很差