promise-ws
A promise based WebSocket implementation for Node.js. Built on top of ws
Table of Contents
Usage examples
Simple client
import WebSocket from "promise-ws";
(async function() {
const ws = await WebSocket.create("ws://www.host.com/path");
ws.on("message", function incoming(data) {
console.log(data);
});
await ws.send("something");
})();
Simple server
import WebSocket from "promise-ws";
(async function() {
const wss = await WebSocket.Server.create({ port: 8080 });
wss.on("connection", async function connection(ws) {
ws.on("message", function incoming(message) {
console.log("received: %s", message);
});
await ws.send("something");
});
})();
Installation
$ npm install promise-ws
API Reference
promise-ws API is almost the same with ws except that:
websocket.ping([data[, mask]])returns a promisewebsocket.pong([data[, mask]])returns a promisewebsocket.send(data[, options])returns a promise-
๐ WebSocket.Server.create(options), returns a promise of listenedWebSocket.Serverinstance -
๐ WebSocket.create(options), returns a promise of openedWebSocketinstance
For more WebSocket API, please checkout the API doc.
License
MIT