功能描述
用于实现网络请求。
支持格式
Json
请求参数:
字段 | 可选 | 类型及范围 | 说明 |
---|---|---|---|
url | 是 | string | 请求的 URL |
method | 否 | string | HTTP 方法 GET 或 POST ,默认GET |
headers | 否 | jsonObject | HTTP 请求头 |
type | 否 | string | 响应类型, json,text 或是 jsonp (在原生实现中其实与 json 相同) |
body | 否 | string | HTTP 请求体 |
timeout | 否 | number | 请求超时时间,单位ms,默认30000ms |
请求调用示例params={
"method":"GET",
"url":"****"
};
LightSDK.native.streamFetch(params,cb);
返回值说明
字段名 | 字段类型 | 说明 |
---|---|---|
status | number | 返回的状态码 |
ok | boolean | 如果状态码在 200~299 之间就为真 |
statusText | string | 状态描述文本 |
data | jsonObject或string | 返回的数据,如果请求类型是 json 和 jsonp,则它就是一个 object ,如果不是,则它就是一个 string。 |
headers | jsonObject | 响应头 |
返回字段示例
{ |
注意事项
- body 参数仅支持 string 类型的参数,请勿直接传递 JSON,必须先将其转为字符串。
- GET 请求不支持 body 方式传递参数,请使用 url 传参。
- url:
- 以/开头为绝对路径,如/abc.json。
- 当页面为远程页面时,根据baseurl转换到域名下。
- 当页面为本地页面时,www本地页面则以www/为根目录, 如www/abc.json。
- 当页面为stream本地页面时,则以stream/[离线包id]/[离线包版本号]为根目录,如stream/lightOffPkg/0.0.1/abc.json。
- 对于url中包含.和.. 的情况,最终路径限制在www/目录与stream/[离线包id]/[离线包版本号]内。即当包含..的url返回的上一级路径不在www/目录与stream/[离线包id]/[离线包版本号]下时,返回ERR_INVALID_REQUEST。