Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/richardeschloss/nuxt-socket-io
Nuxt Socket IO - socket.io client and server module for Nuxt
https://github.com/richardeschloss/nuxt-socket-io
nuxt nuxt-socket-io socket socket-io vue vuejs
Last synced: 6 days ago
JSON representation
Nuxt Socket IO - socket.io client and server module for Nuxt
- Host: GitHub
- URL: https://github.com/richardeschloss/nuxt-socket-io
- Owner: richardeschloss
- License: mit
- Created: 2019-10-03T06:17:32.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-07-25T02:22:16.000Z (over 1 year ago)
- Last Synced: 2024-10-30T02:36:35.745Z (2 months ago)
- Topics: nuxt, nuxt-socket-io, socket, socket-io, vue, vuejs
- Language: JavaScript
- Homepage: https://nuxt-socket-io.netlify.app
- Size: 3.42 MB
- Stars: 264
- Watchers: 7
- Forks: 35
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/nuxt-socket-io)
[](https://www.npmjs.com/package/nuxt-socket-io)
[](https://gitlab.com/richardeschloss/nuxt-socket-io)
[](https://github.com/richardeschloss/nuxt-socket-io/blob/development/LICENSE)
[📖 **Release Notes**](./CHANGELOG.md)
# nuxt-socket-io
[Socket.io](https://socket.io/) client and server module for Nuxt
## Features
- Configuration of multiple IO sockets
- Configuration of per-socket namespaces (simplified format)
- Automatic IO Server Registration
- Socket IO Status
- Automatic Error Handling
- Debug logging, enabled with localStorage item 'debug' set to 'nuxt-socket-io'
- Automatic Teardown, enabled by default
- $nuxtSocket vuex module and socket persistence in vuex
- Support for dynamic APIs using the KISS API format
- Support for the IO config in the new Nuxt runtime config (for Nuxt versions >= 2.13)
- Automatic middleware registration
- ES module
- Experimental support for ioRedis
# Important updates
* v3.x has been tested against Nuxt3 stable and [email protected]. If you absolutely require [email protected] it's recommended to install it and follow the [workaround](https://github.com/richardeschloss/nuxt-socket-io/issues/278#issuecomment-1287133733).
* v2.x may contain breaking changes in it's attempt to get Nuxt3 reaady. `npm i nuxt-socket@1` should help revert any breaking changes in your code.
* VuexOpts types and Namespace configuration types changed. Entries with the `Record` have been deprecated in favor of string-only entries, which are easier to work with.
* Package type is now "module". Entirely ESM.
* Tested against node lts (16.x).
* v1.1.17+ uses socket.io 4.x. You may find the migration [here](https://socket.io/docs/v4/migrating-from-3-x-to-4-0/)
* v1.1.14+ uses socket.io 3.x. You may find the migration [here](https://socket.io/docs/v4/migrating-from-2-x-to-3-0/)
* v1.1.13 uses socket.io 2.x.
# Setup
1. Add `nuxt-socket-io` dependency to your project
* Nuxt 3.x:
```bash
npm i nuxt-socket-io
```
* Nuxt 2.x:
```bash
npm i nuxt-socket-io@2
```
2. Add `nuxt-socket-io` to the `modules` section of `nuxt.config.js`
```js
{
modules: [
'nuxt-socket-io',
],
io: {
// module options
sockets: [{
name: 'main',
url: 'http://localhost:3000'
}]
}
}
```
3. Use it in your components:
```js
{
mounted() {
this.socket = this.$nuxtSocket({
channel: '/index'
})
/* Listen for events: */
this.socket
.on('someEvent', (msg, cb) => {
/* Handle event */
})
},
methods: {
method1() {
/* Emit events */
this.socket.emit('method1', {
hello: 'world'
}, (resp) => {
/* Handle response, if any */
})
}
}
}
```
## Documentation
But WAIT! There's so much more you can do!! Check out the documentation:
> https://nuxt-socket-io.netlify.app/
There you will see:
- More details about the features, configuration and usage
### Resources
- Follow me and the series on [medium.com](https://medium.com/@richard.e.schloss)
- Socket.io Client docs [here](https://socket.io/docs/v4/client-api/)
- Socket.io Server docs [here](https://socket.io/docs/v4/server-api/)
## Development
1. Clone this repository
2. Install dependencies using `yarn install` or `npm install`
3. Start development server using `yarn dev` or `npm run dev`