event-broadcast
v2.0.16
Published
[](https://nodei.co/npm/event-broadcast/)
Downloads
36
Maintainers
j.hasselbringReadme
event-broadcast: A dumified WebSocket wrapper
Browser support based on caniuse.com
| IE / Edge | Firefox | Chrome | Safari | iOS Safari | Samsung | Opera | | --------- | --------- | --------- | --------- | --------- | --------- | --------- | | v10| v11| v16| v7| v6| v4| Not supported
Why did we build event-broadcast?
- Our goal is to make the learning curve to create websockets and real time applications lower.
Why use event-broadcast?
- Multi platform: browsers, apps, servers - Anywhere JavaScript can run that allows WebSockets
- No server needed to get started.
- Free (Paid tier possible in the future)
- Get started in a few lines of code: Seriously, copy the following code and put it in the
<body>of you html then open your html multiple times and see them communicate with each other immediately.
In the browser:
<script src="https://unpkg.com/event-broadcast@latest"></script>
<script>
var chat = new Ca$t();
chat.on('open', function () {
chat.emit('new-user-connected', {
type: 'Browser'
});
chat.on('new-user-connected', function (data) {
console.log('A new client has connected: ' + data.payload.type)
});
});
</script>This may feel like a bunch of magic but, if you put the codes above to any of your pages, those pages will start communicating with each other.
In a NodeJs server:
var Ca$t = require('event-broadcast');
var chat = new Ca$t('https://www.my-super-awesome-domain.com');
chat.on('open', function () {
chat.emit('new-user-connected', {type: 'Server'});
chat.on('new-user-connected', function(data){
console.log('A new client has connected: ' + data.payload.type)
});
});API Docs:
Ca$t('domain'):
The constructor that initialize the connection. The domain parameter is not required. The library will try to automatically detect your domain or host name. It is recommended to provide your domain name to make sure your applications (website or servers) are in the same channel and ablet to communicate with each other.
Parameters:
domain : (String) Not required
The string that will identify your application's channel (Usually your app's domain). All apps that share the same domain will be in the same channel, this includes webapps, mobile apps and node servers.
let mainChannel = new Ca$t('https://domain.com');Ca$t.emit('event-name', {payload}):
Creates and fires an event along with a payload if provided.
Parameters:
event-name : (String) Required
The event identifier that will be emitted/fired. This must match the event listener.
{payload} : (JSON) Not required
The data that will be broadcasted to everyone.
mainChannel.on('event-name', {someData: 'Hello World!'});Ca$t.on('event-name', callBack(data)): Listens to an event then fires callBack().
Parameters:
event-name : (String) Required
The event identifier that the event listener will listen to. This must match the exact event name.
callBack(data) : (callable function) Required
The function that will be executed once the event is fired. If the event is fired with a payload, the callback will receive a parameter conatining the data.
mainChannel.on('event-name', function(data){ console.log(data.payload.someData)});Built in events:
close: Fired when connection is closed or disconnected.- Alias:
onclose
- Alias:
error: Fired when an error occur.- Alias:
onerror
- Alias:
onmessage: Fired when a new message is received.- Alias:
connect: Fired on successfull connection.- Alias:
open,onopen,onconnect
- Alias: