Navigation
These archived docs are for Phaser 2.3.0 Phaser 3 docs can be found on newdocs.phaser.io.
Phaser CE docs can be found on the Phaser CE Documentation site.

Constructor

Phaser. SignalBinding

new SignalBinding(signal, listener, isOnce, listenerContext, priority)

Object that represents a binding between a Signal and a listener function. This is an internal constructor and shouldn't be created directly. Inspired by Joa Ebert AS3 SignalBinding and Robert Penner's Slot classes.

Parameters
Name Type Argument Default Description
signal Phaser.Signal

Reference to Signal object that listener is currently bound to.

listener function

Handler function bound to the signal.

isOnce boolean

If binding should be executed just once.

listenerContext object <optional>
null

Context on which listener will be executed (object that should represent the this variable inside listener function).

priority number <optional>

The priority level of the event listener. (default = 0).

Source code: core/SignalBinding.js (Line 21)

Public Properties

active : boolean

If binding is active and should be executed.

Default Value
  • true
Source code: core/SignalBinding.js (Line 81)

callCount : number

The number of times the handler function has been called.

Source code: core/SignalBinding.js (Line 74)

context : Object

Context on which listener will be executed (object that should represent the this variable inside listener function).

Source code: core/SignalBinding.js (Line 57)

params :array | null

Default parameters passed to listener during Signal.dispatch and SignalBinding.execute (curried parameters).

Type
  • array | null
Default Value
  • null
Source code: core/SignalBinding.js (Line 88)

Public Methods

detach() → {function | null}

Detach binding from signal. alias to: @see mySignal.remove(myBinding.getListener());

Returns
function | null -

Handler function bound to the signal or null if binding was previously detached.

Source code: core/SignalBinding.js (Line 117)

execute(paramsArr) → {any}

Call listener passing arbitrary parameters. If binding was added using Signal.addOnce() it will be automatically removed from signal dispatch queue, this method is used internally for the signal dispatch.

Parameters
Name Type Argument Description
paramsArr Array.<any> <optional>

Array of parameters that should be passed to the listener.

Returns
any -

Value returned by the listener.

Source code: core/SignalBinding.js (Line 90)

getListener() → {function}

Returns
function -

Handler function bound to the signal.

Source code: core/SignalBinding.js (Line 143)

getSignal() → {Phaser.Signal}

Returns

Signal that listener is currently bound to.

Source code: core/SignalBinding.js (Line 151)

isBound() → {boolean}

Returns
boolean -

True if binding is still bound to the signal and has a listener.

Source code: core/SignalBinding.js (Line 127)

isOnce() → {boolean}

Returns
boolean -

If SignalBinding will only be executed once.

Source code: core/SignalBinding.js (Line 135)

toString() → {string}

Returns
string -

String representation of the object.

Source code: core/SignalBinding.js (Line 170)