Engine.IO is the low-level realtime engine behind Socket.IO.
It provides a reliable, bidirectional communication layer between a Node.js server and a client, using HTTP long-polling first and upgrading to better transports when possible, such as WebSocket or WebTransport.
Reliable realtime communication across browsers, networks, proxies, and load balancers
Automatic transport upgrade from HTTP long-polling to WebSocket or WebTransport
Binary data support
Optional HTTP compression and WebSocket per-message deflate
Custom request authorization
Sticky-session-friendly cookie support
Node.js http.Server integration
TypeScript definitions included
Installation
npm install engine.io
Usage
Basic
import { listen } from "engine.io";const server = listen(8080, () => { console.log("listening on port 8080");});server.on("connection", (socket) => { socket.send("hello"); socket.on("message", (data) => { console.log("received:", data); }); socket.on("close", () => { console.log("connection closed");
With an existing HTTP server
import { createServer } from "node:http";import { Server } from "engine.io";const httpServer = createServer();const server = new Server(httpServer);server.on("connection", (socket) => { // ...});httpServer.listen(8080, () => { console.log("listening on port 8080");});
Manual request handling
Use this approach when you want full control over how Engine.IO requests are routed.
import { createServer } from "node:http";import { Server } from "engine.io";const httpServer = createServer();const server = new Server();httpServer.on("request", (req, res) => { server.handleRequest(req, res);});httpServer.on("upgrade", (req, socket, head) => { server.handleUpgrade(req, socket, head);});server.on("connection", (socket) => { // ...});