前言
在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 心跳库 `websocket-heartbeat-miniprogram` 是专为小程序设计的，旨在解决WebSocket连接的稳定性问题。WebSocket是一种在客户端和服务器之间建立长连接的协议，它允许双向通信，使得实时数据交换成为可能。然而，由于网络波动或服务器故障，WebSocket连接可能会意外中断，为此，心跳机制和自动重连功能变得至关重要。
`websocket-heartbeat-miniprogram` 库利用小程序的WebSocket API，提供心跳检测和自动重连功能。当连接断开时，库会自动尝试重新连接，直到成功恢复与服务器的连接。这个库不仅适用于微信小程序，还兼容如百度、支付宝等其他平台的小程序，因为它遵循统一的小程序WebSocket API规范。此外，它也支持像Taro这样的小程序框架。
使用 `websocket-heartbeat-miniprogram` 的步骤如下：
1. 安装：通过npm进行安装，命令为 `npm install --save websocket-heartbeat-miniprogram`。
2. 引入：在你的小程序代码中导入库，例如 `import WebsocketHeartbeat from 'websocket-heartbeat-miniprogram'`。
3. 初始化：调用 `WebsocketHeartbeat` 方法并传入配置参数，包括小程序环境（如 `wx` 对象）和WebSocket连接参数，例如 `url`。
4. 配置钩子函数：使用返回的 `task` 对象设置各种事件处理函数，如 `onOpen`, `onClose`, `onError`, `onMessage` 和 `onReconnect`。
值得注意的是，由于每次重连都会创建新的小程序WebSocket实例，因此直接在原生的 `socketTask` 上注册的监听函数在重连后会丢失。推荐使用库提供的钩子函数，因为它们会在重连后仍然保持有效。
对于支付宝小程序的特殊性，需要注意的是它仅允许存在一个WebSocket连接。如果尝试打开多个连接，先前的连接会被系统关闭，可能导致连接冲突。因此，关闭旧的WebSocket连接必须通过库提供的 `task.close` 方法来实现，以防止不必要的重连行为。
在使用此库时，应遵循以下约定：
1. **主动关闭连接**：必须由前端主动关闭WebSocket连接，避免因异常情况导致的混乱。
2. **依赖库的管理**：确保正确管理和更新此库，以获取最新的兼容性和修复。
3. **错误处理**：充分利用提供的错误处理钩子（`onError`），以便在连接出现问题时采取适当的行动。
`websocket-heartbeat-miniprogram` 是一个实用的工具，它简化了在小程序中维护WebSocket连接的复杂性，提供了稳定的心跳检查和重连机制，让开发者能够更专注于业务逻辑的实现。
