小程序websocket心跳库(websocket-heartbeat-miniprogram)


Posted in Javascript onFebruary 23, 2020

前言

在16年的时候因为项目接触到websocket,而后对心跳重连做了一次总结,写了篇博客,而后18年对之前github上的demo代码进行了再次开发和开源,最终封装成库。如下:

github: https://github.com/zimv/websocket-heartbeat-js
npm: https://www.npmjs.com/package/websocket-heartbeat-js

在2020年也就是今年初,同事建议说可以考虑兼容一下小程序,心想也挺好的。便有了今天的 websocket-heartbeat-miniprogram,这次基于以前的代码新建了一个项目,只做小程序的版本,因为涉及到各种小程序以及相关框架的兼容,觉得还是单独出一个包,更专注一点。

介绍

websocket-heartbeat-miniprogram基于小程序的websocket相关API进行封装,主要目的是保障客户端websocket与服务端连接状态。该程序有心跳检测及自动重连机制,当网络断开或者后端服务问题造成客户端websocket断开,程序会自动尝试重新连接直到再次连接成功。兼容市面上大部分小程序微信,百度,支付宝等,只要都是统一的小程序weboscket-API规范。也支持小程序框架比如Taro等。无论如何,业务是需要一层心跳机制的,否则一些情况下会丢失连接导致功能无法使用。

用法

安装

npm install --save websocket-heartbeat-miniprogram

引入使用

import WebsocketHeartbeat from 'websocket-heartbeat-miniprogram';
WebsocketHeartbeat({
  miniprogram: wx,
  connectSocketParams: {
    url: 'ws://xxx'
  }
})
  .then(task => {
    task.onOpen = () => {//钩子函数
      console.log('open');
    };
    task.onClose = () => {//钩子函数
      console.log('close');
    };
    task.onError = e => {//钩子函数
      console.log('onError:', e);
    };
    task.onMessage = data => {//钩子函数
      console.log('onMessage', data);
    };
    task.onReconnect = () => {//钩子函数
      console.log('reconnect...');
    };
    task.socketTask.onOpen(data => {//原生实例注册函数,重连后丢失
      console.log('socketTask open');
    });
    task.socketTask.onMessage(data => {//原生实例注册函数,重连后丢失
      console.log('socketTask data');
    });
  })

本程序内部总是使用小程序connectSocket方法进行socket连接,如果socket断开,本程序内部会再次执行小程序的connectSocket方法,以此来重新建立连接,重连都会建立新的小程序socket实例。

WebsocketHeartbeat方法返回一个promise,返回的task对象是本程序的一个实例,提供了onOpen,onClose,onError,onMessage,onReconnect等钩子函数。也暴露了小程序本身的实例(socketTask),task.socketTask就是小程序connectSocket返回的实例,而task.socketTask是小程序的原生实例,它们通过onXXX方法传递函数进行监听注册,在socket重连以后,内部重新通过connectSocket新建实例,将会返回新的小程序原生实例,因此之前通过socketTask.onXXX注册的这些函数将会丢失。而本程序内部提供的钩子函数重连上以后依然有效。大部分情况下推荐就使用本程序的钩子函数。

支付宝小程序差异

支付宝小程序只允许同时存在一个socket连接,原生的API也和其他小程序有一点小差异,本程序已经做了兼容,但是还是要注意支付宝只允许建立一个socket,如果建立多个socket,前面的socket都会被系统关闭,一定要通过本程序实例的task.close关闭旧的socket,否则程序会一直重连,导致所有socket相互冲突无法使用。

约定

1.只能通过前端主动关闭socket连接

如果需要断开socket,应该执行task.close()方法。如果后端想要关闭socket,应该下发一个消息,前端判断此消息,前端再调用task.close()方法关闭。因为无论是后端调用close还是因为其他原因造成的socket关闭,前端的socket都会触发onClose事件,程序无法判断是什么原因导致的关闭。因此本程序会默认尝试重连。

import WebsocketHeartbeat from 'websocket-heartbeat-miniprogram';
WebsocketHeartbeat({
  miniprogram: wx,
  connectSocketParams: {
    url: 'ws://xxxx'
  }
})
  .then(task => {
    task.onMessage = data => {
      if(data.data == 'close') task.close();//关闭socket并且,不再重连
    };
  })

2.后端对前端心跳的反馈

前端发送心跳消息,后端收到后,需要立刻返回响应消息,后端响应的消息可以是任何值,因为本程序并不处理和判断响应的心跳消息,而只是在收到任何消息后,重置心跳,因为收到任何消息就说明连接是正常的。因此本程序收到任何后端返回的消息都会重置心跳倒计时,以此来减少不必要的请求,减少服务器压力。

API

详情参考: https://github.com/zimv/websocket-heartbeat-miniprogram

结语

程序已经经过单元测试,也在百度,支付宝,微信等小程序之中实际测试和基于Taro测试。程序长期维护,发现兼容问题或者程序问题,希望得到issue反馈!

到此这篇关于小程序websocket心跳库(websocket-heartbeat-miniprogram)的文章就介绍到这了,更多相关小程序websocket心跳库内容请搜索三水点靠木以前的文章或继续浏览下面的相关文章希望大家以后多多支持三水点靠木!

Javascript 相关文章推荐
关于onchange事件在IE和FF下的表现及解决方法
Mar 08 Javascript
jquery跨域请求示例分享(jquery发送ajax请求)
Mar 25 Javascript
超链接怎么正确调用javascript函数
May 23 Javascript
JQuery点击行tr实现checkBox选中的简单实例
May 26 Javascript
jQuery 更改checkbox的状态,无效的解决方法
Jul 22 Javascript
Ajax分页插件Pagination从前台jQuery到后端java总结
Jul 22 Javascript
关于vue.js弹窗组件的知识点总结
Sep 11 Javascript
js返回顶部实例分享
Dec 21 Javascript
一种angular的方法级的缓存注解(装饰器)
Mar 13 Javascript
详解vue-cli@2.x项目迁移日志
Jun 06 Javascript
JS轮播图的实现方法
Aug 24 Javascript
几款主流好用的富文本编辑器(所见即所得常用编辑器)介绍
Mar 17 Javascript
webpack.DefinePlugin与cross-env区别详解
Feb 23 #Javascript
深入理解webpack process.env.NODE_ENV配置
Feb 23 #Javascript
微信小程序实现限制用户转发功能的实例代码
Feb 22 #Javascript
vue.js实现简单的计算器功能
Feb 22 #Javascript
Vue.js实现立体计算器
Feb 22 #Javascript
vue实现计算器功能
Feb 22 #Javascript
js实现网页版贪吃蛇游戏
Feb 22 #Javascript
You might like
很实用的一个完整email发送程序
2006/10/09 PHP
15种PHP Encoder的比较
2007/03/06 PHP
WordPress中限制非管理员用户在文章后只能评论一次
2015/12/31 PHP
PHP使用strrev翻转中文乱码问题的解决方法
2017/01/13 PHP
总结一些PHP中好用但又容易忽略的小知识
2017/06/02 PHP
JavaScript 轻松搞定快捷留言功能 只需一行代码
2010/04/01 Javascript
jQuery对象[0]是什么含义?
2010/07/31 Javascript
JS中把字符转成ASCII值的函数示例代码
2013/11/21 Javascript
Blocksit插件实现瀑布流数据无限( 异步)加载
2014/06/20 Javascript
js实现可折叠展开的手风琴菜单效果
2015/09/07 Javascript
JS验证输入的是否是数字及保留几位小数问题
2018/05/09 Javascript
React 源码中的依赖注入方法
2018/11/07 Javascript
Vue核心概念Getter的使用方法
2019/01/18 Javascript
简单两步使用node发送qq邮件的方法
2019/03/01 Javascript
让 babel webpack vue 配置文件支持智能提示的方法
2019/06/22 Javascript
微信小程序实现多选框功能的实例代码
2020/06/24 Javascript
[42:34]VP vs VG 2018国际邀请赛小组赛BO2 第一场 8.19
2018/08/21 DOTA
Python运算符重载用法实例分析
2015/06/01 Python
pandas数据框,统计某列数据对应的个数方法
2018/04/11 Python
Python实现在某个数组中查找一个值的算法示例
2018/06/27 Python
利用matplotlib实现根据实时数据动态更新图形
2019/12/13 Python
python+Selenium自动化测试——输入,点击操作
2020/03/06 Python
python3中sys.argv的实例用法
2020/04/24 Python
Django权限控制的使用
2021/01/07 Python
CSS3中使用RGBA设置透明度的示例
2015/08/04 HTML / CSS
艺术设计专业个人求职信
2013/09/21 职场文书
医学检验专业个人求职信范文
2013/12/04 职场文书
校园自助餐厅的创业计划书
2013/12/26 职场文书
应届电子商务毕业自荐书范文
2014/02/11 职场文书
乔丹名人堂演讲稿
2014/05/24 职场文书
政府个人对照检查材料思想汇报
2014/10/08 职场文书
嘉宾邀请函
2015/01/31 职场文书
全国爱眼日活动总结
2015/02/27 职场文书
2015年度优秀员工推荐信
2015/03/23 职场文书
经销商会议开幕词
2016/03/04 职场文书
使用Redis实现秒杀功能的简单方法
2021/05/08 Redis