emissary travis-ci npm

Node mixins for subscribing to and emitting events *no longer maintained*

3 years after

Emissary – Mixins for Events Build Status

Achtung! This library is currently used in Atom and various Atom dependencies, but our long-term plan is to transition away from it in favor of the simpler event-kit library. Don't depend on supporting this library forever.

Achtung Again! The Subscriber mixin requires ES6 Harmony WeakMaps. To enable them, run your program with the node --harmony_collections flag. If you're using it in a node framework such as jasmine, run its script with the flag enabled as follows: node --harmony-collections .bin/jasmine-node specs.

Emitter

Emitter is backward-compatible with Node's event emitter, but offers more functionality. You can construct standalone Emitter instances or use it as a mixin.

  • Emitter.extend(object) Turns the given object into an emitter by adding the appropriate methods.

  • Emitter.includeInto(class) Turns the class into an emitter by extending its prototype.

  • ::on(eventNames, handler) Subscribe to one or more events. Events names are separated by spaces, and can optionally be namespaced with a dot-suffix. E.g. event1 event2.namespace.

  • ::once(eventName, handler) Like ::on, but only fires the handler once before unsubscribing automatically.

  • ::off(eventNames[, handler]) Unsubscribe to one or more events. Event names are separated by spaces. Passing a non-namespaced event name unsubscribes from every namespace for that event. Passing only a namespace unsubscribes from that entire namespace. Passing a handler removes only a subscription corresponding to the given event name(s) and that handler.

  • ::emit(eventName[, data...]) Emit an event with the given name. If the event name is namespaced, only calls handlers for the event associated with the namespace, otherwise it fires all handlers. Handlers are called with zero or more data arguments provided after the event name.

  • ::pauseEvents() Buffers events instead of emitting them until ::resumeEvents is called.

  • ::resumeEvents() Emits all events buffered since pausing and resumes normal emitting behavior.

  • ::getSubscriptionCount() Get the total number of handlers registered on the emitter.

Subscriber

Subscriber works in partnership with an emitter or any object supporting subscription cancellation with .off. This includes standard Node event emitters and jQuery objects.

  • ::subscribe(object, eventNames, handler) Subscribe to the given event name(s) on the given object.

  • ::subscribeWith(object, methodName, eventNames, handler) Subscribe to the given object with a method other than .on.

  • ::unsubscribe([object]) Cancel subscriptions previously registered with ::subscribe. If an object is given, only unsubscribe from that object. If called without an object, unsubscribe from everything.

Related Repositories

APTnotes

APTnotes

Various public documents, whitepapers and articles about APT campaigns ...

AngularJS-UGAT

AngularJS-UGAT

The Ultimate Guidebook for Automated Testing (for AngularJS 1.X projects) ...

awesome-scifi

awesome-scifi

Sci-Fi worth consuming ...

battlescribe-this_is_not_a_test

battlescribe-this_is_not_a_test

Battlescribe data files for the This is Not a Test miniatures game. ...

awesome-scifi

awesome-scifi

Sci-Fi worth consuming ...


Top Contributors

nathansobo kevinsawicki SamyPesse Termina1 PeterDaveHello liuxiong332

Releases

-   v1.3.3 zip tar
-   v1.3.2 zip tar
-   v1.3.1 zip tar
-   v1.3.0 zip tar
-   v1.2.2 zip tar
-   v1.2.1 zip tar
-   v1.2.0 zip tar
-   v1.1.0 zip tar
-   v1.0.0 zip tar
-   v0.31.0 zip tar
-   v0.30.0 zip tar
-   v0.29.0 zip tar
-   v0.28.0 zip tar
-   v0.27.0 zip tar
-   v0.26.0 zip tar
-   v0.25.0 zip tar
-   v0.24.0 zip tar
-   v0.23.0 zip tar
-   v0.22.0 zip tar
-   v0.21.0 zip tar
-   v0.20.0 zip tar
-   v0.19.0 zip tar
-   v0.18.0 zip tar
-   v0.17.0 zip tar
-   v0.16.0 zip tar
-   v0.15.0 zip tar
-   v0.14.0 zip tar
-   v0.13.0 zip tar
-   v0.12.0 zip tar
-   v0.11.0 zip tar