官网介绍
https://wendux.github.io/dist/#/doc/flyio/readme
一个支持所有JavaScript运行环境的基于Promise的、支持请求转发、强大的http请求库。可以让您在多个端上尽可能大限度的实现代码复用。其兼容性是它一大优势。
浏览器兼容性
其它平台
目前Fly.js支持的平台包括:Node.js 、微信小程序 、Weex 、React Native 、Quick App 和浏览器。不过官方文档中已经说明,更多平台正在持续加入,后续肯定会支持更多的平台。
安装和使用
安装方式和普通的js差不多
- npm包安装
npm install flyio
- 浏览器引入
<script src="https://unpkg.com/flyio/dist/fly.min.js"></script>
- 浏览器端使用方式(其它环境请参考官网文档)
//index.html
<script src="https://unpkg.com/flyio/dist/fly.min.js"></script>
<script>
let fly = new Fly();
fly.get('./data.json').then(res => {
console.log(res);
}).catch(function (error) {
console.log(error);
});
</script>
//data.json
{
"weatherinfo": {
"city": "北京",
"cityid": "101010100",
"temp": "27.9",
"WD": "南风",
"WS": "小于3级",
"SD": "28%",
"AP": "1002hPa",
"njd": "暂无实况",
"WSE": "<3",
"time": "17:55",
"sm": "2.1",
"isRadar": "1",
"Radar": "JC_RADAR_AZ9010_JB"
}
}
查看浏览器返回的结果
使用
- get请求
fly.get(url, data, options)//option是请求配置项
- post请求
fly.post(url, data, options)//option是请求配置项
- request
fly.request(url, data, options)//option是请求配置项
- request结构对象
{
headers:{}, //http请求头,
baseURL:"", //请求基地址
timeout:0,//超时时间,为0时则无超时限制
//是否自动将Content-Type为“application/json”的响应数据转化为JSON对象,默认为true
parseJson:true,
withCredentials:false //跨域时是否发送cookie
}
示例:
//GET请求
fly.request("/user/8" null, {method:"get"})
//DELETE 请求
fly.request("/user/8/delete", null, {method:"delete"})
//PUT请求
fly.request("/user/register", {name:"doris"}, {method:"PUT"})
- response对象结构
{
data, //服务器返回的数据
engine, //请求使用的http engine(见下面文档),浏览器中为本次请求的XMLHttpRequest对象
headers, //响应头信息
request //本次响应对应的请求信息
}
- 别名方法
fly.put(url, data, options) fly.delete(url,data,options) fly.patch(url,data,options) fly.all([]) fly.spread([])
还有更多用法请直接参考官方文档
对比axios和fetch
官网有更详细的的介绍,大家可以直接参考官网。
备注
- fly不支持jsonp
- fly只能设置并维护一个拦截器
- 可以清除拦截器
- 不支持请求取消
- 支持请求重定向
总结
flyJS是一个http请求的终极的解决方案,Fly最大的特点就是在混合APP中支持请求转发,而axios不支持,fly采用分层的思想,通过替换底层http engine(Fly中提出了Http Engine的概念)的方式实现各种环境的适配。能够实现很多高级的玩法。