WebSocketMQ 是一个基于 WebSocket 协议的消息队列库，能够方便地实现基于消息的通信。在前端开发中，如果需要实现可靠的异步通信，WebSocketMQ 是一个非常好的选择。本文将介绍 WebSocketMQ 的基本用法和高级用法，帮助读者快速上手。
安装和基础用法
WebSocketMQ 可以通过 npm 安装：
npm install --save websocketmq
使用时需要引入该库：
import WebSocketMQ from 'websocketmq';
创建 WebSocketMQ 实例：
const wsmq = new WebSocketMQ('ws://localhost:12345');以上代码创建了一个 WebSocketMQ 实例，并建立了与 ws://localhost:12345 这个 WebSocket 地址的连接。如果使用 wss 协议，可以将地址改为 wss://your-domain.com。
现在可以通过 wsmq 对象进行消息的发送和接收了。WebSocketMQ 支持以下方法：
subscribe(topic: string, callback: (message: any, topic: string) => void): void：订阅 topic，当有新消息到达时，callback 函数就会被调用。message 是消息内容，topic 是消息主题。unsubscribe(topic: string, callback: (message: any, topic: string) => void): void：取消订阅。publish(topic: string, message: any): void：发布消息，将 message 发送到主题为 topic 的队列中。
以下是一个简单的示例：
const wsmq = new WebSocketMQ('ws://localhost:12345');
wsmq.subscribe('my-topic', (message, topic) => {
console.log(`Received message "${message}" on topic "${topic}"`)
});
wsmq.publish('my-topic', 'Hello World!');高级用法
确认模式
WebSocketMQ 支持确认模式。在确认模式下，发送者会等待接收者的响应，以确保消息被正确地接收。
确认模式需要在发送消息时指定。以下是示例代码：
-- -------------------- ---- ------- ----- --------- - ----------------------------------- - ----- ------ ------- --- ----------------------------------- -- - -------------------- ------------ ------------- --- -------------------------------- -- - ------------------- -- ------- ------- ---------------- ---
在上面的示例中，publishWithConfirm 方法会返回一个消息 ID，这个 ID 可以用于确认和失败回调中进行识别。当消息被成功接收时，onPublishConfirmed 回调函数会被调用；当消息接收失败时，onPublishFailed 回调函数会被调用。
消息过期
WebSocketMQ 还支持消息过期机制。你可以为每条消息设置过期时间，如果消息在一定时间内没有被处理，就会被自动删除。以下是示例代码：
const messageId = wsmq.publish('my-topic', { data: 'Hello World!' }, { ttl: 60 * 1000 });
wsmq.onMessageExpired((messageId) => {
console.log(`Message ${messageId} expired!`);
});在上面的示例中，publish 方法的第三个参数是一个选项对象，其中 ttl 属性指定了消息的过期时间（单位是毫秒）。当消息过期后，onMessageExpired 回调函数会被调用。
总结
WebSocketMQ 是一个非常实用的消息队列库，它可以帮助前端开发者实现可靠的异步通信。本文介绍了 WebSocketMQ 的基本用法和高级用法，希望能对读者有所帮助。如果你想深入了解 WebSocketMQ 的实现原理，建议查看官方文档。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600671068dd3466f61ffde0d