Class BodyListener

Listener for body lifecycle events.

Fires when a body matching the options filter wakes or sleeps.

Valid events: CbEvent.WAKE, CbEvent.SLEEP.

Example

const listener = new BodyListener(
  CbEvent.WAKE,
  CbType.ANY_BODY,
  (cb) => { console.log(cb.body, 'woke up'); },
);
space.listeners.add(listener);

Fully modernized from nape-compiled.js lines 434–515.

Hierarchy (View Summary)

Listener
- BodyListener

Index

Constructors

constructor

new BodyListener(
    event: CbEvent,
    options: CbType | OptionType | null,
    handler: (cb: BodyCallback) => void,
    precedence?: number,
): BodyListener
Parameters
- event: CbEvent
  Must be CbEvent.WAKE or CbEvent.SLEEP.
- options: CbType | OptionType | null
  CbType or OptionType filter, or null to match all bodies.
- handler: (cb: BodyCallback) => void
  Called with a BodyCallback each time the event fires.
- precedence: number = 0
  Execution order relative to other listeners (higher = first). Default 0.
Returns BodyListener
Overrides Listener.constructor
- Defined in packages/nape-js/src/callbacks/BodyListener.ts:45

Accessors

event

get event(): CbEvent
The event this listener responds to.

Valid values depend on the concrete listener type — see CbEvent. Changing this while the listener is assigned to a space re-registers it.

Returns CbEvent
Inherited from Listener.event
- Defined in packages/nape-js/src/callbacks/Listener.ts:85
set event(event: CbEvent): void
Parameters
- event: CbEvent
Returns void
Inherited from Listener.event
- Defined in packages/nape-js/src/callbacks/Listener.ts:89

handler

get handler(): (cb: BodyCallback) => void
The callback function invoked when the event fires. Cannot be set to null.

Returns (cb: BodyCallback) => void
- Defined in packages/nape-js/src/callbacks/BodyListener.ts:90
set handler(handler: (cb: BodyCallback) => void): void
Parameters
- handler: (cb: BodyCallback) => void
Returns void
- Defined in packages/nape-js/src/callbacks/BodyListener.ts:94

options

get options(): OptionType
The filter used to match bodies. Returns an OptionType representing the current include/exclude configuration.

Returns OptionType
- Defined in packages/nape-js/src/callbacks/BodyListener.ts:81
set options(options: CbType | OptionType): void
Parameters
- options: CbType | OptionType
Returns void
- Defined in packages/nape-js/src/callbacks/BodyListener.ts:85

precedence

get precedence(): number
Execution priority of this listener relative to other listeners for the same event. Higher values execute first.

Returns number
Default Value
0
Inherited from Listener.precedence
- Defined in packages/nape-js/src/callbacks/Listener.ts:105
set precedence(precedence: number): void
Parameters
- precedence: number
Returns void
Inherited from Listener.precedence
- Defined in packages/nape-js/src/callbacks/Listener.ts:109

space

get space(): Space | null
The space this listener is currently registered in, or null if not registered.

Assign to register/unregister the listener in a space:
```
listener.space = mySpace;  // register
listener.space = null;     // unregister
```
Returns Space | null
Inherited from Listener.space
- Defined in packages/nape-js/src/callbacks/Listener.ts:125
set space(space: Space | null): void
Parameters
- space: Space | null
Returns void
Inherited from Listener.space
- Defined in packages/nape-js/src/callbacks/Listener.ts:133

type

get type(): ListenerType
The type of this listener (BODY, CONSTRAINT, INTERACTION, or PRE).

Returns ListenerType
Inherited from Listener.type
- Defined in packages/nape-js/src/callbacks/Listener.ts:75

Methods

toString

toString(): string
Returns string
Inherited from Listener.toString
- Defined in packages/nape-js/src/callbacks/Listener.ts:154

Class BodyListener

Example

Hierarchy (View Summary)

Index

Constructors

Accessors

Methods

Constructors

constructor

Parameters

Returns BodyListener

Accessors

event

Returns CbEvent

Parameters

Returns void

handler

Returns (cb: BodyCallback) => void

Parameters

Returns void

options

Returns OptionType

Parameters

Returns void

precedence

Returns number

Default Value

Parameters

Returns void

space

Returns Space | null

Parameters

Returns void

type

Returns ListenerType

Methods

toString

Returns string

Settings

On This Page