stream
模块提供了基本的网络请求能力,例如 GET 请求、POST 请求等,用于在组件的生命周期内与服务端进行交互。
# # API
## # fetch
发起一个请求。
#### # fetch(options, callback, progressCallback)
- @options, 请求的配置选项,支持以下配置
- method
, string, HTTP 请求方法,值为 GET
/POST
/PUT
/DELETE
/PATCH
/HEAD
- url
, string, 请求的 URL | string
- headers
, string, 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 之间就为 true
- statusText
, string, 状态描述文本
- data
, string, 返回的数据,如果请求类型是 json
和 jsonp
,则它就是一个 object
,否则是一个 string
。
- headers
, object, rHTTP 响应头
-
@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 请求获取数据。
在 GitHub 上编辑此页
最后一次更新: 6/7/2019, 8:03:58 AM