uWebsockets.js for FreeBSD
Go to file
2020-10-15 18:56:37 +02:00
.github/workflows Also use GitHub Actions for Windows 2020-09-18 22:36:43 +02:00
docs Add listen(port, options, callback) overload to TS def (#357) 2020-08-23 23:56:27 +02:00
examples Wrap missingServerName, update example 2020-08-17 05:41:00 +02:00
misc Add files via upload 2020-06-09 17:32:02 +02:00
src Remove uWS.free, WorkerThreads graceful shutdown 2020-10-15 18:43:32 +02:00
tests Pass Autobahn again 2019-10-09 20:30:50 +02:00
uWebSockets@59a38b3a13 Update uWS.getParts for dealing with empty parts 2020-10-14 22:01:14 +02:00
.gitattributes Don't include js files in language stats 2019-04-10 12:42:00 +02:00
.gitmodules Add uWebSockets submodule 2018-11-04 00:11:12 +01:00
build.c Require macOS Mojave 2020-10-15 18:56:37 +02:00
LICENSE Apache 2.0 license 2018-11-15 16:01:49 +01:00
Makefile Make sure to handle double uWS.free 2019-12-21 19:38:02 +01:00
README.md Update README.md 2020-09-20 16:05:53 +02:00


Simple, secure[1] & standards compliant[2] web server for the most demanding[3] of applications. Read more...

Language grade: C/C++

A note on speculation, lies & allegations



💡 Familiar face

µWebSockets.js is a C++ implementation of the Http/WebSocket protocols for Node.js, easy to use from JavaScript. Think of it as a faster Express.js/Socket.IO alternative; it comes with both router and pub/sub support. Browse the documentation and see the main repo. There are tons of examples but here's the gist of it all:

/* Non-SSL is simply App() */
require('uWebSockets.js').SSLApp({

  /* There are more SSL options, cut for brevity */
  key_file_name: 'misc/key.pem',
  cert_file_name: 'misc/cert.pem',
  
}).ws('/*', {

  /* There are many common helper features */
  idleTimeout: 30,
  maxBackpressure: 1024,
  maxPayloadLength: 512,
  compression: DEDICATED_COMPRESSOR_3KB,

  /* For brevity we skip the other events (upgrade, open, ping, pong, close) */
  message: (ws, message, isBinary) => {
    /* You can do app.publish('sensors/home/temperature', '22C') kind of pub/sub as well */
    
    /* Here we echo the message back, using compression if available */
    let ok = ws.send(message, isBinary, true);
  }
  
}).get('/*', (res, req) => {

  /* It does Http as well */
  res.writeStatus('200 OK').writeHeader('IsExample', 'Yes').end('Hello there!');
  
}).listen(9001, (listenSocket) => {

  if (listenSocket) {
    console.log('Listening to port 9001');
  }
  
});

💪 Unfair advantage

Being written in native code directly targeting the Linux kernel makes it way faster than any JavaScript implementation.

📦 Install anywhere

Install with npm install uNetworking/uWebSockets.js#v18.5.0 or any such release. No compiler needed.

  • Runs on Linux, macOS and Windows (ARM64, x64). Node.js 10, 11, 12, 13 & 14.
  • Installs from this GitHub repository, not the NPM registry; hit "fork" to get your own copy.

💼 Commercially supported

uNetworking AB is a Swedish consulting & contracting company dealing with anything related to µWebSockets; development, support and customer success.

Don't hesitate sending a mail if you're building something large, in need of advice or having other business inquiries in mind. We'll figure out what's best for both parties and make sure you're not stepping into one of the many common pitfalls.

Special thanks to BitMEX, Bitfinex, Google, Coinbase, Bitwyre and deepstreamHub for allowing the project itself to thrive on GitHub since 2016 - this project would not be possible without these beautiful companies.

  • µWebSockets.js is the Node.js binding to µWebSockets. Read more over at µWebSockets.