Skip to main content
Version: Phaser v3.88.2

Data.Events

CHANGE_DATA

Description: The Change Data Event.

This event is dispatched by a Data Manager when an item in the data store is changed.

Game Objects with data enabled have an instance of a Data Manager under the data property. So, to listen for

a change data event from a Game Object you would use: sprite.on('changedata', listener).

This event is dispatched for all items that change in the Data Manager.

To listen for the change of a specific item, use the CHANGE_DATA_KEY_EVENT event.

nametypeoptionaldescription
parentanyNoA reference to the object that the Data Manager responsible for this event belongs to.
keystringNoThe unique key of the data item within the Data Manager.
valueanyNoThe new value of the item in the Data Manager.
previousValueanyNoThe previous value of the item in the Data Manager.

Member of: Phaser.Data.Events

Source: src/data/events/CHANGE_DATA_EVENT.js#L7
Since: 3.0.0

CHANGE_DATA_KEY

Description: The Change Data Key Event.

This event is dispatched by a Data Manager when an item in the data store is changed.

Game Objects with data enabled have an instance of a Data Manager under the data property. So, to listen for

the change of a specific data item from a Game Object you would use: sprite.on('changedata-key', listener),

where key is the unique string key of the data item. For example, if you have a data item stored called gold

then you can listen for sprite.on('changedata-gold').

nametypeoptionaldescription
parentanyNoA reference to the object that owns the instance of the Data Manager responsible for this event.
valueanyNoThe item that was updated in the Data Manager. This can be of any data type, i.e. a string, boolean, number, object or instance.
previousValueanyNoThe previous item that was updated in the Data Manager. This can be of any data type, i.e. a string, boolean, number, object or instance.

Member of: Phaser.Data.Events

Source: src/data/events/CHANGE_DATA_KEY_EVENT.js#L7
Since: 3.16.1

DESTROY

Description: The Data Manager Destroy Event.

The Data Manager will listen for the destroy event from its parent, and then close itself down.

Member of: Phaser.Data.Events

Source: src/data/events/DESTROY_EVENT.js#L7
Since: 3.50.0

REMOVE_DATA

Description: The Remove Data Event.

This event is dispatched by a Data Manager when an item is removed from it.

Game Objects with data enabled have an instance of a Data Manager under the data property. So, to listen for

the removal of a data item on a Game Object you would use: sprite.on('removedata', listener).

nametypeoptionaldescription
parentanyNoA reference to the object that owns the instance of the Data Manager responsible for this event.
keystringNoThe unique key of the data item within the Data Manager.
dataanyNoThe item that was removed from the Data Manager. This can be of any data type, i.e. a string, boolean, number, object or instance.

Member of: Phaser.Data.Events

Source: src/data/events/REMOVE_DATA_EVENT.js#L7
Since: 3.0.0

SET_DATA

Description: The Set Data Event.

This event is dispatched by a Data Manager when a new item is added to the data store.

Game Objects with data enabled have an instance of a Data Manager under the data property. So, to listen for

the addition of a new data item on a Game Object you would use: sprite.on('setdata', listener).

nametypeoptionaldescription
parentanyNoA reference to the object that owns the instance of the Data Manager responsible for this event.
keystringNoThe unique key of the data item within the Data Manager.
dataanyNoThe item that was added to the Data Manager. This can be of any data type, i.e. a string, boolean, number, object or instance.

Member of: Phaser.Data.Events

Source: src/data/events/SET_DATA_EVENT.js#L7
Since: 3.0.0