More details about this release in the blog post: https://socket.io/blog/socket-io-3-release/
Dedicated migration guide: https://socket.io/docs/migrating-from-2-x-to-3-0/
Features
- emit an Error object upon middleware error (0939395)
- add bundle with msgpack parser (71d6048)
- add support for catch-all listeners (55f464f)
- add volatile events (7ddad2c)
- move binary detection back to the parser (1789094)
- add ES6 module export (cbabb03)
- do not reuse the Engine.IO id (bbe94ad)
- remove the implicit connection to the default namespace (249e0be)
- split the events of the Manager and Socket (132f8ec)
- throw upon reserved event names (6494f61)
BREAKING CHANGES
- the Socket instance will now emit a "connect_error" event instead of "error" (which is not a reserved event anymore)
// before
socket.on("error", () => {});
// after
socket.on("connect_error", () => {});
-
the Socket#binary() method is removed, as this use case is now covered by the ability to provide your own parser.
-
the Socket instance will no longer forward the events of its Manager
Those events can still be accessed on the Manager instance though:
socket.io.on("reconnect", () => {
// ...
});
Links:
- Milestone: 3.0.0
- Diff: 2.3.1...3.0.0
- Server release: 3.0.0
- engine.io-client version:
~4.0.0
- ws version:
~7.2.1
- Build size
socket.io.min.js
:60.7 KB
socket.io.msgpack.min.js
:61.8 KB