Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mafintosh/localcast

A shared event emitter that works across multiple processes on the same machine, including the browser!
https://github.com/mafintosh/localcast

Last synced: 12 days ago
JSON representation

A shared event emitter that works across multiple processes on the same machine, including the browser!

Awesome Lists containing this project

README

        

# localcast

A shared event emitter that works across multiple processes on the same machine, including the browser!

```
npm install localcast
```

## Usage

First save the example below in file called `example.js`.

``` js
var localcast = require('localcast')
var cast = localcast()

cast.on('hello', function (data) {
console.log('hello', data)
})

cast.emit('hello', 'world')
```

Then try running the example in a terminal.

``` sh
# in one terminal
$ node example.js
```

Running the above should print out `hello world` and keep the process running.

Then try running opening a new terminal and run the example again.

``` sh
# in a new terminal
$ node example.js
```

Both the new and old terminal should print out `hello world`.

Now try browserifying the example

``` sh
browserify example.js > bundle.js
echo '' > example.html
```

Open `example.html` in a browser. Now both the browser and the two previous terminals should print out `hello world`!

## API

#### `var cast = localcast([name])`

Create a new localcast event emitter.

Optionally you can give it a name if you are running multiple and want them to avoid clashing.

#### `cast.on('localcast', peer)`

Whenever you are connected to another localcast instance a special `localcast` event is emitted with an object describing the other instance.

``` js
cast.on('localcast', function (peer) {
console.log('we are connected to another instance', peer)
})
```

If the other peer is a browser the peer looks like this

``` js
{
type: 'browser',
localhost: urlOfWebsite
}
```

If the other peer is a node process it looks like this

``` js
{
type: 'node',
pid: pid
}
```

## License

MIT