`µWS` is one of the most lightweight, efficient & scalable WebSocket server implementations available. It features an easy-to-use, fully async object-oriented interface and scales to millions of connections using only a fraction of memory compared to the competition. While performance and scalability are two of our top priorities, we consider security, stability and standards compliance paramount. License is zlib/libpng (very permissive & suits commercial applications). * Autobahn tests [all pass](http://htmlpreview.github.io/?https://github.com/uWebSockets/uWebSockets/blob/master/autobahn/index.html). * Linux, OS X & Windows support. * Valgrind clean. * Built-in load balancing and multi-core scalability. * SSL/TLS support & integrates with foreign HTTPS servers. * Permessage-deflate built-in. * Node.js binding exposed as the well-known `ws` interface. * 10-300x faster than `ws` (if they are "fastest", we are "fastester"). * Default engine in SocketCluster & deepstream.io, optional in Socket.IO & Primus. [![npm version](https://badge.fury.io/js/uws.svg)](https://badge.fury.io/js/uws) [![](https://api.travis-ci.org/uWebSockets/uWebSockets.svg?branch=master)](https://travis-ci.org/uWebSockets/uWebSockets) [![](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/uWebSockets/uWebSockets) ## Benchmarks table - [validate](https://github.com/alexhultman/uWebSockets/tree/master/benchmarks#websocket-echo-server-benchmarks) Implementation | User space memory scaling | Connection performance | Short message throughput | Huge message throughput --- | --- | --- | --- | --- libwebsockets 2.0 | µWS is **11x** as lightweight | µWS is **equal** in performance | µWS is **6x** as performant | µWS is **4x** in performance ws v1.1.0 + binary addons | µWS is **47x** as lightweight | µWS is **18x** as performant | µWS is **33x** as performant | µWS is **2x** as performant WebSocket++ v0.7.0 | µWS is **63x** as lightweight | µWS is **4x** as performant | µWS is **3x** as performant | µWS is **2x** as performant Kaazing Gateway Community 5.0.0 | µWS is **62x** as lightweight | µWS is **15x** as performant | µWS is **18x** as performant | unable to measure *Benchmarks are run with default settings in all libraries, except for `ws` which is run with the native performance addons. These results were achieved with the native C++ server, not the Node.js addon. Expect worse performance and scalability when using Node.js (don't worry, the Node.js addon will run circles around `ws`).* ## Built with µWS


WebTorrent	deepstream.io	SocketCluster	Fortune.js	wilds.io	Crisp.im	droppy

## Usage ### Node.js We built `µWS` with the existing Node.js infrastructure in mind. That's why we target the widespread `ws` interface, allowing us to seamlessly integrate with projects like SocketCluster, deepstream.io, Socket.IO & Primus. * Read the [ws documentation](https://github.com/websockets/ws/blob/master/doc/ws.md) * Read the [Primus transformer documentation](https://github.com/primus/primus#uws) There are some important incompatibilities with `ws` though, we aim to be ~90% compatible but will never implement behavior that is deemed too inefficient: * Binary data is passed zero-copy as an `ArrayBuffer`. This means you need to copy it to keep it past the callback. It also means you need to convert it with `Buffer.from(message)` if you expect a `Node.js Buffer`. * `webSocket._socket` is not a `net.Socket`, it is just a getter function with very basic functionalities. * `webSocket._socket.remote...` might fail, you need to cache it at connection. * `webSocket` acts like an `EventEmitter` with one listener per event maximum. * `webSocket.upgradeReq` is only valid during execution of the connection handler. If you want to keep properties of the upgradeReq for the entire lifetime of the webSocket you better attach that specific property to the webSocket at connection. ##### SocketCluster `µWS` is the default engine in [SocketCluster](http://socketcluster.io) as of 5.0.0. ##### deepstream.io `µWS` is the default engine in [deepstream.io](http://deepstream.io/) as of 1.0.0. It is also deeply integrated into the server as of 1.2.0. ##### Socket.IO Use the new `wsEngine: 'uws'` option like so: ```javascript var io = require('socket.io')(80, { wsEngine: 'uws' }); ``` This option has not yet been released, one alternative way of enabling `uws` in current versions of Socket.IO is: ```javascript var io = require('socket.io')(80); io.engine.ws = new (require('uws').Server)({ noServer: true, perMessageDeflate: false }); ``` ##### Primus Set 'uws' as transformer: ```javascript var primus = new Primus(server, { transformer: 'uws' }); ``` ##### ws If your code directly relies on `ws` you can simply swap `require('ws')` with `require('uws')`: ```javascript var WebSocketServer = require('uws').Server; var wss = new WebSocketServer({ port: 8080 }); wss.on('connection', function (ws) { ws.on('message', function (message) { console.log('received: ' + message); }); ws.send('something'); }); ``` ### C++ For maximum performance and memory scaling the native interface is recommended. Look in the examples folder for threading and load balancing examples. There is no documentation written yet but a bright person like you will have no problem just reading the header file. ```c++ #include int main() { uWS::Hub h; h.onMessage([](uWS::WebSocket ws, char *message, size_t length, uWS::OpCode opCode) { ws.send(message, length, opCode); }); h.listen(3000); h.run(); } ``` ## Quality control * Valgrind clean. * Autobahn tests [all pass](http://htmlpreview.github.io/?https://github.com/alexhultman/uWebSockets/blob/master/autobahn/index.html). * All Primus transformer integration tests pass. * All Engine.IO server tests pass. * Small & efficient code base. ## Installation ### Node.js developers [![](https://nodei.co/npm/uws.png)](https://www.npmjs.com/package/uws) * Node.js 4.x, 5.x & 6.x supported (Windows version requires Node.js 6.4.0+) * Linux, Mac OS X & Windows supported Prebuilt native modules are provided for most modern platforms. If the prebuilt module fails to load, `gcc` > 4.8.0 (or compatible) and `make` are required to build the native module from source. ### C++ developers #### Dependencies First of all you need to install the required dependencies. On Unix systems this is typically done via package managers, like [homebrew](http://brew.sh) in the case of OS X or `dnf` in the case of Fedora Linux. On Windows you need to search the web for pre-compiled binaries or simply compile the dependencies yourself. * libuv 1.3+ * OpenSSL 1.0.x * zlib 1.x * CMake 3.x #### Compilation Obviously you will need to clone this repo to get the sources. We use CMake as build system. * `git clone https://github.com/uWebSockets/uWebSockets.git && cd uWebSockets` * `cmake .` Now, on Unix systems it should work by simply running `make`. Run [sudo] `make install` as you wish. ##### Windows, in all its glory If you are running Windows you should now have a bunch of Visual Studio project files and one solution file. Open the solution file, now you need to make sure the header include paths and library paths are all set according to where you installed the dependencies. You might also need to change the names of the libraries being linked against, all according to the names of the installed library files. You know the drill.

	Stars	Issues	Version	Updated	Created
express-ws	865	78	5.0.2	3 years ago	10 years ago
socket.io			4.7.5	2 months ago	13 years ago
sockjs	2,089	19	0.3.24	2 years ago	13 years ago
uws-new-build			0.10.11	8 years ago	8 years ago
ws	21,086	7	8.17.0	5 days ago	12 years ago

express-ws vs socket.io vs sockjs vs uws-new-build vs ws

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Popular Searches

Sick of boring JavaScript newsletters?

Downloads in past