一、接口声明
在src/manifest.json中声明权限。
代码语言:javascript复制{ "name": "blueos.network.fetch" }
二、导入模块
在script中导入模块。
代码语言:javascript复制import fetch from '@blueos.network.fetch' 或 const fetch = require('@blueos.network.fetch')
三、查看接口文档fetch.fetch(OBJECT)
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
url | String | 是 | 资源 url |
data | String/Object/ArrayBuffer | 否 | 请求的参数,可以是字符串,或者是 js 对象、arraybuffer 对象。参考 data与Content-Type关系 部分 |
header | Object | 否 | 请求的 header,会将其所有属性设置到请求的 header 部分。User-Agent 设置在版本开始支持。示例:{"Accept-Encoding": "gzip, deflate","Accept-Language": "zh-CN,en-US;q=0.8,en;q=0.6"} |
method | String | 否 | 默认为 GET,可以是:OPTIONS,GET,HEAD,POST,PUT,DELETE,TRACE,CONNECT |
responseType | String | 否 | 支持返回类型是 text,json,file,arraybuffer,默认会根据服务器返回 header 中的 Content-Type 确定返回类型,详见 success返回值。 |
success | Function | 否 | 成功返回的回调函数 |
fail | Function | 否 | 失败的回调函数,可能会因为权限失败 |
complete | Function | 否 | 结束的回调函数(调用成功、失败都会执行) |
data 与 Content-Type 关系
data | Content-Type | 说明 |
---|---|---|
String | 不设置 | Content-Type 默认为 text/plain,data 值作为请求的 body |
String | 任意 Type | data 值作为请求的 body |
Object | 不设置 | Content-Type 默认为 application/x-www-form-urlencoded,data 按照 url 规则进行 encode 拼接作为请求的 body |
Object | application/x-www-form-urlencoded | data 按照 url 规则进行 encode 拼接作为请求的 body |
Object | application/x-www-form-urlencoded 之外的任意 type | 会将 data 转为字符串作为请求的 body |
ArrayBuffer | 不设置 | Content-Type 默认为 application/octet-stream,data 值作为请求的 body |
ArrayBuffer | 任意 Type | data 值作为请求的 body |
success 返回值:
参数名 | 类型 | 说明 |
---|---|---|
code | Integer | 服务器状态 code |
data | String/Object /ArrayBuffer | 参考 responseType与success中data关系 部分 |
headers | Object | 服务器 response 的所有 header |
responseType 与 success 中 data 关系:
responseType | data | 说明 |
---|---|---|
无 | String | 服务器返回的 header 中 type 是 text/*或 application/json、application/javascript、application/xml,值是文本内容,否则是存储的临时文件的 uri,临时文件如果是图片或者视频内容,可以将图片设置到 image 或 video 控件上显示 |
text | String | 返回普通文本 |
json | Object | 返回 js 对象 |
file | String | 返回存储的临时文件的 uri |
arraybuffer | ArrayBuffer | 返回 ArrayBuffer 对象 |
四、发起请求
完整源码
代码语言:javascript复制 onBtnClick() {
fetch.fetch({
url: 'https://v2.alapi.cn/api/mingyan?token=qlVquQZPYSeaCi6u',
header: {
'Content-Type': 'application/json'
},
success: function (response) {
console.log(`the status code of the response: ${response.code}`)
console.log(`the headers of the response: ${JSON.stringify(response.data)}`)
},
fail: function (data, code) {
console.log(`handling fail, errMsg = ${data}`)
console.log(`handling fail, errCode = ${code}`)
},
})
}
查看控制台输出。
五、完整源码
完整源码
代码语言:javascript复制<template>
<div class="wrapper">
<text class="title">{{ title }} </text>
<text>{{ key }}</text>
<text>{{ message.data.content }}</text>
<text>{{ '作者:' message.data.author }}</text>
<input
class="btn"
type="button"
value="获取网络数据"
onclick="onBtnClick"
/>
</div>
</template>
<script>
import fetch from '@system.fetch'
console.log(typeof fetch.fetch)
export default {
data: {
title: '