Package Exports

lil-event

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (lil-event) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

lil'-event

Tiny event bus inspired in Node's EventEmitter

Name	event
Version	0.1.0
Size	2 KB / 1 KB (gzipped)
Environment	Node, Browser

Installation

Node.js

npm install lil-event

Browser

Via Bower

bower install lil-event

Via Component

component install lil-js/event

Or loading the script remotely

<script src="//cdn.rawgit.com/lil-js/event/0.1.0/event.js"></script>

Environments

Node.js
Chrome >= 5
Firefox >= 3
Safari >= 5
Opera >= 10
IE >= 9

Usage

You could fetch de module via require() if it's available. Otherwise, global fallback will be used, exposed via lil.Event

var lil = require('lil-event')

Basic emitter API

function connectDB() {
  var bus = new lil.Event()
  db.connect(uri)
    .on('error', function (err) {
      emitter.emit('error', err)
    })
    .on('success', function () {
      emitter.emit('start', db)
    })
  return bus
}

Event bus suscription

connectDB()
  .on('error', onErrorHandler)
  .on('start', onStartHandler)

API

lil.Event()

Create a new Event bus

lil.Event#on(event, fn)

Alias: addListener Return: this

Subscribe to an specific event

lil.Event#once(event, fn)

Alias: addOnceListener Return: this

Subcribe to an specific event for a once time. After event is emitted, the handler will be flushed from the listeners pool

lil.Event#off(event, fn)

Alias: addListener Return: this

Unsubscribe an event listener by name and function

lil.Event#emit(event, [ arguments... ])

Alias: fire Return: this

Fire an event on the current bus

lil.Event.VERSION

Contributing

Wanna help? Cool! It will be appreciated :)

You must add new test cases for any new feature or refactor you do, always following the same design/code patterns that already exist

Development

Only node.js is required for development

Clone the repository

$ git clone https://github.com/lil-js/event.git && cd event

Install dependencies

$ npm install

Generate browser bundle source

$ make browser

Run tests

$ make test

lil-event