NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #2359 most downloaded on npm
default socket.io in-memory adapter
Latest stable
2.5.8
Last release 5 months ago
16 Jun 2026
Release timing varies
gaps range from 9 days to 1.5 years
Most releases are documented
notes for 21 of 30 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
32 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
The ws dependency was bumped to ~8.21.0 following CVE-2026-48779.
The ws dependency was bumped to ~8.21.0 following CVE-2026-48779.
The ws dependency was bumped to ~8.20.1 following CVE-2026-45736.
The ws dependency was bumped to ~8.20.1 following CVE-2026-45736.
Note from the ws maintainers:
Although the calculated CVSS severity is medium, the actual severity is believed to be low, as the flaw is only exploitable through misuse that is unlikely in practice.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
This release contains a bump of:
This release contains a bump of:
ws from ~8.17.1 to ~8.18.3debug from ~4.3.1 to ~4.4.1This release contains a bump of the ws dependency, which includes an important security fix.
This release contains a bump of the ws dependency, which includes an important security fix.
Advisory: https://github.com/advisories/GHSA-3h5v-q93c-6h6q
ensure the order of the commands
Two abstract classes were imported from the Redis adapter repository:
Two abstract classes were imported from the Redis adapter repository:
ClusterAdapter class, which manages the messages sent between the server instances of the clusterClusterAdapterWithHeartbeat class, which extends the ClusterAdapter and adds a heartbeat mechanism in order to check the healthiness of the other instancesOther adapters can then just extend those classes and only have to implement the pub/sub mechanism (and not the internal chit-chat protocol):
class MyAdapter extends ClusterAdapterWithHeartbeat {
constructor(nsp, pubSub, opts) {
super(nsp, opts);
this.pubSub = pubSub;
pubSub.subscribe("main-channel", (message) => this.onMessage(message));
pubSub.subscribe("specific-channel#" + this.uid, (response) => this.onResponse(response));
}
doPublish(message) {
return this.pubSub.publish("main-channel", message);
}
doPublishResponse(requesterUid, response) {
return this.pubSub.publish("specific-channel#" + requesterUid, response);
}
}
Besides, the number of "timeout reached: only x responses received out of y" errors (which can happen when a server instance leaves the cluster) should be greatly reduced by this commit.
The ws dependency was moved from peerDependencies to dependencies, in order to prevent issues like this.
The ws dependency was moved from peerDependencies to dependencies, in order to prevent issues like this.
add a noop handler for the error event
-~3.6.0 (no change)~7.5.10The default value of the maxHttpBufferSize option has been decreased from 100 MB to 1 MB, in order to prevent attacks by denial of service.
:warning: WARNING :warning:
The default value of the maxHttpBufferSize option has been decreased from 100 MB to 1 MB, in order to prevent attacks by denial of service.
Security advisory: https://github.com/advisories/GHSA-j4f2-536g-r55m
:warning: BREAKING CHANGE :warning:
Related blog post: https://socket.io/blog/socket-io-2-4-0/
:warning: BREAKING CHANGE :warning:
Previously, CORS was enabled by default, which meant that a Socket.IO server sent the necessary CORS headers (Access-Control-Allow-xxx) to any domain. This will not be the case anymore, and you now have to explicitly enable it.
Please note that you are not impacted if:
origins option to restrict the list of allowed domainsThis commit also removes the support for '*' matchers and protocol-less URL:
io.origins('https://example.com:443'); => io.origins(['https://example.com']);
io.origins('localhost:3000'); => io.origins(['http://localhost:3000']);
io.origins('http://localhost:*'); => io.origins(['http://localhost:3000']);
io.origins('*:3000'); => io.origins(['http://localhost:3000']);
To restore the previous behavior (please use with caution):
io.origins((_, callback) => {
callback(null, true);
});
See also:
Thanks a lot to @ni8walk3r for the security report.
fix broadcasting volatile packets with binary attachments
fix race condition when leaving rooms
restore compatibility with binary parsers
This release mainly contains a bump of the engine.io and ws packages, but no additional features.
This release mainly contains a bump of the engine.io and ws packages, but no additional features.
add cache-control header when serving the client source
There are two non-breaking changes that are somehow quite important:
// by default, the object is recursively scanned to check whether it contains some binary data
// in the following example, the check is skipped in order to improve performance
socket.binary(false).emit('plain-object', object);
// it also works at the namespace level
io.binary(false).emit('plain-object', object);
io.of(/^\/dynamic-\d+$/).on('connect', (socket) => {
// socket.nsp.name = '/dynamic-101'
});
// client-side
const client = require('socket.io-client')('/dynamic-101');
There are two non-breaking changes that are somehow quite important:
ws was reverted as the default wsEngine (https://github.com/socketio/engine.io/pull/550), as there was several blocking issues with uws. You can still use uws by running npm install uws --save in your project and using the wsEngine option:var engine = require('engine.io');
var server = engine.listen(3000, {
wsEngine: 'uws'
});
pingTimeout now defaults to 5 seconds (instead of 60 seconds): https://github.com/socketio/engine.io/pull/551reset rooms object before broadcasting
engine.io: -ws: -### Features * add init() and close() methods
Nothing published for this version
fix timing issues with middleware
engine.io: -ws: -The dist/ directory was not up-to-date when publishing the previous version...
## Bug fixes - update path of client file (#2934) #### Links: - Milestone: 2.0.1 - Diff: 2.0.0...2.0.1 - Client release: 2.0.1 - Diff engine.io: - - D
- update path of client file (#2934)
engine.io: -ws: -a breaking change related to utf-8 encoding in engine.io-parser
This major release brings several performance improvements:
uws is now the default Websocket engine. It should bring significant improvement in performance (particularly in terms of memory consumption) (https://github.com/socketio/engine.io/releases/tag/2.0.0)
the Engine.IO and Socket.IO handshake packets were merged, reducing the number of roundtrips necessary to establish a connection. (#2833)
it is now possible to provide a custom parser according to the needs of your application (#2829). Please take a look at the example for more information.
Please note that this release is not backward-compatible, due to:
Please also note that if you are using a self-signed certificate, rejectUnauthorized now defaults to true (https://github.com/socketio/engine.io-client/pull/558).
Finally, the API documentation is now in the repository (here), and the content of the website here. Do not hesitate if you see something wrong or missing!
The full list of changes:
local flag (#2816)clients method in the API documentation (#2812)Besides, we are proud to announce that Socket.IO is now a part of open collective: https://opencollective.com/socketio. More on that later.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release contains an important refactor of the adapter (this commit), as most of the logic has been moved in the ClusterAdapter class of the socke
This release contains an important refactor of the adapter (this commit), as most of the logic has been moved in the ClusterAdapter class of the socket.io-adapter package.
Besides, the @socket.io/cluster-adapter package is now part of the socket.io monorepo.
Nothing published for this version
Nothing published for this version
One column per quarter.