socketio/socket.io (socket.io)
### [`v4.8.1`](https://redirect.github.com/socketio/socket.io/releases/tag/socket.io-client%404.8.1)
[Compare Source](https://redirect.github.com/socketio/socket.io/compare/socket.io@4.8.0...socket.io@4.8.1)
##### Bug Fixes
- **bundle:** do not mangle the "\_placeholder" attribute ([ca9e994](https://redirect.github.com/socketio/socket.io/commit/ca9e994815aa2e31e0342e37ccdc2e9e8c5fd13c))
##### Dependencies
- [`engine.io-client@~6.6.1`](https://redirect.github.com/socketio/engine.io-client/releases/tag/6.5.2) (no change)
- [`ws@~8.17.1`](https://redirect.github.com/websockets/ws/releases/tag/8.17.1) (no change)
### [`v4.8.0`](https://redirect.github.com/socketio/socket.io/releases/tag/socket.io-client%404.8.0)
[Compare Source](https://redirect.github.com/socketio/socket.io/compare/socket.io@4.7.5...socket.io@4.8.0)
##### Features
##### Custom transport implementations
The `transports` option now accepts an array of transport implementations:
```js
import { io } from "socket.io-client";
import { XHR, WebSocket } from "engine.io-client";
const socket = io({
transports: [XHR, WebSocket]
});
```
Here is the list of provided implementations:
| Transport | Description |
|-----------------|------------------------------------------------------------------------------------------------------|
| `Fetch` | HTTP long-polling based on the built-in `fetch()` method. |
| `NodeXHR` | HTTP long-polling based on the `XMLHttpRequest` object provided by the `xmlhttprequest-ssl` package. |
| `XHR` | HTTP long-polling based on the built-in `XMLHttpRequest` object. |
| `NodeWebSocket` | WebSocket transport based on the `WebSocket` object provided by the `ws` package. |
| `WebSocket` | WebSocket transport based on the built-in `WebSocket` object. |
| `WebTransport` | WebTransport transport based on the built-in `WebTransport` object. |
Usage:
| Transport | browser | Node.js | Deno | Bun |
|-----------------|--------------------|------------------------|--------------------|--------------------|
| `Fetch` | :white_check_mark: | :white_check_mark: (1) | :white_check_mark: | :white_check_mark: |
| `NodeXHR` | | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| `XHR` | :white_check_mark: | | | |
| `NodeWebSocket` | | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| `WebSocket` | :white_check_mark: | :white_check_mark: (2) | :white_check_mark: | :white_check_mark: |
| `WebTransport` | :white_check_mark: | :white_check_mark: | | |
(1) since [v18.0.0](https://nodejs.org/api/globals.html#fetch)
(2) since [v21.0.0](https://nodejs.org/api/globals.html#websocket)
Added in [f4d898e](https://redirect.github.com/socketio/engine.io-client/commit/f4d898ee9652939a4550a41ac0e8143056154c0a) and [b11763b](https://redirect.github.com/socketio/engine.io-client/commit/b11763beecfe4622867b4dec9d1db77460733ffb).
##### Test each low-level transports
When setting the `tryAllTransports` option to `true`, if the first transport (usually, HTTP long-polling) fails, then the other transports will be tested too:
```js
import { io } from "socket.io-client";
const socket = io({
tryAllTransports: true
});
```
This feature is useful in two cases:
- when HTTP long-polling is disabled on the server, or if CORS fails
- when WebSocket is tested first (with `transports: ["websocket", "polling"]`)
The only potential downside is that the connection attempt could take more time in case of failure, as there have been reports of WebSocket connection errors taking several seconds before being detected (that's one reason for using HTTP long-polling first). That's why the option defaults to `false` for now.
Added in [579b243](https://redirect.github.com/socketio/engine.io-client/commit/579b243e89ac7dc58233f9844ef70817364ecf52).
##### Bug Fixes
- accept string | undefined as init argument (bis) ([60c757f](https://redirect.github.com/socketio/socket.io/commit/60c757f718d400e052c3160ee377bbe4973277c9))
- allow to manually stop the reconnection loop ([13c6d2e](https://redirect.github.com/socketio/socket.io/commit/13c6d2e89deb1e6c6c8c7245118f9b37d66537cb))
- close the engine upon decoding exception ([04c8dd9](https://redirect.github.com/socketio/socket.io/commit/04c8dd979ce40acaceec1f4507c1ae69325d6158))
- do not send a packet on an expired connection ([#5134](https://redirect.github.com/socketio/socket.io/issues/5134)) ([8adcfbf](https://redirect.github.com/socketio/socket.io/commit/8adcfbfde50679095ec2abe376650cf2b6814325))
##### Dependencies
- [`engine.io-client@~6.6.1`](https://redirect.github.com/socketio/engine.io-client/releases/tag/6.5.2) ([diff](https://redirect.github.com/socketio/engine.io-client/compare/6.5.3...6.6.0) and [diff](https://redirect.github.com/socketio/socket.io/compare/engine.io-client@6.6.0...engine.io-client@6.6.1))
- [`ws@~8.17.1`](https://redirect.github.com/websockets/ws/releases/tag/8.17.1) ([diff](https://redirect.github.com/websockets/ws/compare/8.11.0...8.17.1))
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Enabled.
♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about these updates again.
[ ] If you want to rebase/retry this PR, check this box
This PR contains the following updates:
^4.7.5->^4.8.1^4.7.5->^4.8.1Release Notes
socketio/socket.io (socket.io)
### [`v4.8.1`](https://redirect.github.com/socketio/socket.io/releases/tag/socket.io-client%404.8.1) [Compare Source](https://redirect.github.com/socketio/socket.io/compare/socket.io@4.8.0...socket.io@4.8.1) ##### Bug Fixes - **bundle:** do not mangle the "\_placeholder" attribute ([ca9e994](https://redirect.github.com/socketio/socket.io/commit/ca9e994815aa2e31e0342e37ccdc2e9e8c5fd13c)) ##### Dependencies - [`engine.io-client@~6.6.1`](https://redirect.github.com/socketio/engine.io-client/releases/tag/6.5.2) (no change) - [`ws@~8.17.1`](https://redirect.github.com/websockets/ws/releases/tag/8.17.1) (no change) ### [`v4.8.0`](https://redirect.github.com/socketio/socket.io/releases/tag/socket.io-client%404.8.0) [Compare Source](https://redirect.github.com/socketio/socket.io/compare/socket.io@4.7.5...socket.io@4.8.0) ##### Features ##### Custom transport implementations The `transports` option now accepts an array of transport implementations: ```js import { io } from "socket.io-client"; import { XHR, WebSocket } from "engine.io-client"; const socket = io({ transports: [XHR, WebSocket] }); ``` Here is the list of provided implementations: | Transport | Description | |-----------------|------------------------------------------------------------------------------------------------------| | `Fetch` | HTTP long-polling based on the built-in `fetch()` method. | | `NodeXHR` | HTTP long-polling based on the `XMLHttpRequest` object provided by the `xmlhttprequest-ssl` package. | | `XHR` | HTTP long-polling based on the built-in `XMLHttpRequest` object. | | `NodeWebSocket` | WebSocket transport based on the `WebSocket` object provided by the `ws` package. | | `WebSocket` | WebSocket transport based on the built-in `WebSocket` object. | | `WebTransport` | WebTransport transport based on the built-in `WebTransport` object. | Usage: | Transport | browser | Node.js | Deno | Bun | |-----------------|--------------------|------------------------|--------------------|--------------------| | `Fetch` | :white_check_mark: | :white_check_mark: (1) | :white_check_mark: | :white_check_mark: | | `NodeXHR` | | :white_check_mark: | :white_check_mark: | :white_check_mark: | | `XHR` | :white_check_mark: | | | | | `NodeWebSocket` | | :white_check_mark: | :white_check_mark: | :white_check_mark: | | `WebSocket` | :white_check_mark: | :white_check_mark: (2) | :white_check_mark: | :white_check_mark: | | `WebTransport` | :white_check_mark: | :white_check_mark: | | | (1) since [v18.0.0](https://nodejs.org/api/globals.html#fetch) (2) since [v21.0.0](https://nodejs.org/api/globals.html#websocket) Added in [f4d898e](https://redirect.github.com/socketio/engine.io-client/commit/f4d898ee9652939a4550a41ac0e8143056154c0a) and [b11763b](https://redirect.github.com/socketio/engine.io-client/commit/b11763beecfe4622867b4dec9d1db77460733ffb). ##### Test each low-level transports When setting the `tryAllTransports` option to `true`, if the first transport (usually, HTTP long-polling) fails, then the other transports will be tested too: ```js import { io } from "socket.io-client"; const socket = io({ tryAllTransports: true }); ``` This feature is useful in two cases: - when HTTP long-polling is disabled on the server, or if CORS fails - when WebSocket is tested first (with `transports: ["websocket", "polling"]`) The only potential downside is that the connection attempt could take more time in case of failure, as there have been reports of WebSocket connection errors taking several seconds before being detected (that's one reason for using HTTP long-polling first). That's why the option defaults to `false` for now. Added in [579b243](https://redirect.github.com/socketio/engine.io-client/commit/579b243e89ac7dc58233f9844ef70817364ecf52). ##### Bug Fixes - accept string | undefined as init argument (bis) ([60c757f](https://redirect.github.com/socketio/socket.io/commit/60c757f718d400e052c3160ee377bbe4973277c9)) - allow to manually stop the reconnection loop ([13c6d2e](https://redirect.github.com/socketio/socket.io/commit/13c6d2e89deb1e6c6c8c7245118f9b37d66537cb)) - close the engine upon decoding exception ([04c8dd9](https://redirect.github.com/socketio/socket.io/commit/04c8dd979ce40acaceec1f4507c1ae69325d6158)) - do not send a packet on an expired connection ([#5134](https://redirect.github.com/socketio/socket.io/issues/5134)) ([8adcfbf](https://redirect.github.com/socketio/socket.io/commit/8adcfbfde50679095ec2abe376650cf2b6814325)) ##### Dependencies - [`engine.io-client@~6.6.1`](https://redirect.github.com/socketio/engine.io-client/releases/tag/6.5.2) ([diff](https://redirect.github.com/socketio/engine.io-client/compare/6.5.3...6.6.0) and [diff](https://redirect.github.com/socketio/socket.io/compare/engine.io-client@6.6.0...engine.io-client@6.6.1)) - [`ws@~8.17.1`](https://redirect.github.com/websockets/ws/releases/tag/8.17.1) ([diff](https://redirect.github.com/websockets/ws/compare/8.11.0...8.17.1))Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Enabled.
♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about these updates again.
This PR was generated by Mend Renovate. View the repository job log.