Code Monkey home page Code Monkey logo

qi-events's Introduction

Qi Events

Version npmBuild StatusDependenciesCoverage StatusAPI Documentation

http://drkibitz.github.io/qi-events/

A no nonsense event API (BASED ON Backbone.Events).

Goals

  • Maintain a no nonsense event dispatching/emitting/triggering API.
  • Test it.
  • Find a happy medium between simplicity, speed, and usage.
  • Should be able to perform well in high performance situations.
  • Allow for the most common use cases, but within reason to maintain high performance.
  • Embrace CommonJS Module format
  • Allow for UglifyJS and Closure Compiler with ADVANCED_OPTIMIZATIONS.
  • Allow for use as the basis of other event implmentations (scenegraph)

Usage

There are just 4 main methods to remember.

Use the mixin method to allow any object to trigger events.

require('qi-events').mixin({});
    .on('myevent', console.log, console)
    .trigger('myevent', 'something')
    .trigger('myevent', 'something', 'something')
    .trigger('myevent', 'something', 'something', 'darkside');

// > something
// > something something
// > something something darkside

Mixin into any prototype object.

var events = require('qi-events');
function MyEmitter() {}
events.mixin(MyEmitter.prototype);
var emitter = new MyEmitter();
emitter
    .on('myevent', console.log, console)
    .trigger('myevent', 'something', 'something', 'darkside');

// > something something darkside

Extend the provided class.

var Events = require('qi-events').Events;
function MyEmitter() {}
MyEmitter.prototype = Object.create(Events.prototype, {
    constructor: {value: MyEmitter}
});
var emitter = new MyEmitter();
emitter
    .on('myevent', console.log, console)
    .trigger('myevent', 'something', 'something', 'darkside');

// > something something darkside

Use the module itself as a central dispatcher.

require('qi-events');
    .once('myevent', console.log, console)
    .trigger('myevent', 'something', 'something', 'darkside');

// > something something darkside

Changes since Backbone.Events

Backbone.js 0.9.10 (c) 2010-2013 Jeremy Ashkenas, DocumentCloud Inc. Backbone may be freely distributed under the MIT license. For all details and documentation: http://backbonejs.org

  1. Added "use strict"

  2. Converted to CommonJS module

  3. Module is a constructor that can be used with class inheritence

  4. Removed very minor dependencies on underscore.js and Backbone.js

    1. Added mixin method to replace Backbone mixin functionality
    2. Underscore was only used for slice, just using the native method
  5. Completely removed listenTo(), listenToOnce(), and stopListening() methods

  6. Change eventsApi() to accept an array of event names

  7. Change eventsApi() to receive function references instead of "action" strings

    1. This is a micro optimization and allows better obfuscation
  8. trigger() no longer calls eventsApi(), this is a very rare (and mostly unnecessary) use case that can be avoided

    1. Optimization is important when triggering, but convenience is important when adding and removing
  9. With trigger not using eventsApi(), it allowed further optimizations on eventsApi() and trigger()

    1. Removed ctx property from _events[name] object, just use context property instead
    2. Fixed lint errors in the process
  10. Added aStart argument to triggerEvents() as a logical slice removing slice call for most cases

Why not EventEmitter?

So I think we already have four separate versions of EventEmitter at the time of writing this paragraph (April 2015). At this point in time, I am refusing to raise that count to five, or linking to any of them. Just to be clear, I am pretty sure I published this library when there were only two versions published, and I originally implemented my changes privately on top of Backbone.Events before it was broken up into parts. With all of this said, though I may be biased, I still prefer this library. If you are interested in how this API compares to the EventEmitter API, the following example should help.

var events = require('qi-events');

function EventEmitter25() {}
var proto = EventEmitter25.prototype;

proto.emit = events.trigger;
proto.on = proto.addListener = events.on;
proto.once = events.once;
proto.removeListener = events.off;

proto.listeners = function (event) {
    if (!this._events || !this._events[event]) return [];
    for (var i = 0, l = this._events[event].length, arr = new Array(l); i < l; i++) {
        arr[i] = this._events[event][i].callback;
    }
    return arr;
};

proto.removeAllListeners = function (event) {
    return events.off.call(this, event);
};

proto.setMaxListeners = function () {
    return this;
};

module.exports = EventEmitter25;

qi-events's People

Contributors

bitdeli-chef avatar drkibitz avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.