Home Reference Source
public class | source

EventEmitter

A standards compatible event handler (observer) with some sugar.

Constructor Summary

Public Constructor
public

Create Event Handler

Member Summary

Public Members
public

Registered events

public

The name of the handler

Method Summary

Public Methods
public

Destroys all events

public

emit(name: string | string[], args: *): EventEmitter

Emits an event

public

off(name: string | string[], callback: Function, force: boolean): EventEmitter

Removes an event handler

public

on(name: string | string[], callback: Function, options: object): EventEmitter

Add an event handler

public

once(name: *, callback: *): EventEmitter

Adds an event handler that only fires once

Public Constructors

public constructor(name: string) source

Create Event Handler

Params:

NameTypeAttributeDescription
name string
  • optional

A name for logging

Public Members

public events: object source

Registered events

public name: string source

The name of the handler

Public Methods

public destroy() source

Destroys all events

public emit(name: string | string[], args: *): EventEmitter source

Emits an event

You can supply an array of event names or a comma separated list with a string

Params:

NameTypeAttributeDescription
name string | string[]

Event name

args *
  • optional

Arguments

Return:

EventEmitter

Returns current instance

public off(name: string | string[], callback: Function, force: boolean): EventEmitter source

Removes an event handler

If no callback is provided, all events bound to given name will be removed.

You can supply an array of event names or a comma separated list with a string

Params:

NameTypeAttributeDescription
name string | string[]

Event name

callback Function
  • optional

Callback function

force boolean
  • optional
  • default: false

Forces removal even if set to persis

Return:

EventEmitter

Returns current instance

public on(name: string | string[], callback: Function, options: object): EventEmitter source

Add an event handler

You can supply an array of event names or a comma separated list with a string

Params:

NameTypeAttributeDescription
name string | string[]

Event name

callback Function

Callback function

options object
  • optional

Options

options.persist boolean
  • optional

This even handler cannot be removed unless forced

options.once boolean
  • optional

Fire only once

Return:

EventEmitter

Returns current instance

public once(name: *, callback: *): EventEmitter source

Adds an event handler that only fires once

Params:

NameTypeAttributeDescription
name *
callback *

Return:

EventEmitter

Returns current instance