Class webdriver.EventEmitter

code »

Object that can emit events for others to listen for. This is used instead of Closure's event system because it is much more light weight. The API is based on Node's EventEmitters.

Constructor

webdriver.EventEmitter ( )
Show:

Instance Methods

code »addListener ( type, listenerFn, opt_scope )!webdriver.EventEmitter

Registers a listener.

Parameters
type: string
The type of event to listen for.
listenerFn: !Function
The function to invoke when the event is fired.
opt_scope: Object=
The object in whose scope to invoke the listener.
Returns
A self reference.
code »addListener_ ( type, listenerFn, opt_scope, opt_oneshot )!webdriver.EventEmitter

Registers a listener.

Parameters
type: string
The type of event to listen for.
listenerFn: !Function
The function to invoke when the event is fired.
opt_scope: Object=
The object in whose scope to invoke the listener.
opt_oneshot: boolean=
Whether the listener should be removed after the first event is fired.
Returns
A self reference.
code »emit ( type, var_args )

Fires an event and calls all listeners.

Parameters
type: string
The type of event to emit.
var_args: ...*
Any arguments to pass to each listener.
code »listeners ( type )!Array

Returns a mutable list of listeners for a specific type of event.

Parameters
type: string
The type of event to retrieve the listeners for.
Returns
The registered listeners for the given event type.
code »on ( type, listenerFn, opt_scope )!webdriver.EventEmitter

An alias for #addListener().

Parameters
type: string
The type of event to listen for.
listenerFn: !Function
The function to invoke when the event is fired.
opt_scope: Object=
The object in whose scope to invoke the listener.
Returns
A self reference.
code »once ( type, listenerFn, opt_scope )!webdriver.EventEmitter

Registers a one-time listener which will be called only the first time an event is emitted, after which it will be removed.

Parameters
type: string
The type of event to listen for.
listenerFn: !Function
The function to invoke when the event is fired.
opt_scope: Object=
The object in whose scope to invoke the listener.
Returns
A self reference.

Removes all listeners for a specific type of event. If no event is specified, all listeners across all types will be removed.

Parameters
opt_type: string=
The type of event to remove listeners from.
Returns
A self reference.

Removes a previously registered event listener.

Parameters
type: string
The type of event to unregister.
listenerFn: !Function
The handler function to remove.
Returns
A self reference.

Instance Properties

Map of events to registered listeners.