# stream
stream
模块提供了基本的网络请求能力,例如 GET 请求、POST 请求等,用于在组件的生命周期内与服务端进行交互。
# API
# fetch
发起一个请求。
# fetch(options, callback, progressCallback)
- @options, 请求的配置选项,支持以下配置
method
, string, HTTP 请求方法,值为GET
/POST
/PUT
/DELETE
/PATCH
/HEAD
url
, string, 请求的 URL | stringheaders
, object, HTTP 请求头type
, string, 响应类型:json
,text
或是jsonp
(在 native 原生实现中其实与json
相同)body
, string, HTTP 请求体
注意
body
参数仅支持string
类型的参数,请勿直接传递JSON
,必须先将其转为字符串。GET
请求不支持body
方式传递参数,请使用 URL 传参。- 默认
Content-Type
是application/x-www-form-urlencoded
。 - 如果你需要通过 POST 发送 json 数据, 需要将
Content-Type
设为application/json
。
@callback, 响应结果回调,回调函数将收到如下的
response
对象:status
, number, 返回的状态码ok
, boolean, 如果状态码在 200-299 之间就为 truestatusText
, string, 状态描述文本data
, string, 返回的数据,如果请求类型是json
和jsonp
,则它就是一个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'。
示例
- HTTP method 示例
- Post 示例,常见应用场景,发送 POST 请求。
- Get 示例,常见应用场景,通过 GET 请求获取数据。