Phaser.Loader.Events

ADD

Scope: instance

Description: The Loader Plugin Add File Event.

This event is dispatched when a new file is successfully added to the Loader and placed into the load queue.

Listen to it from a Scene using: this.load.on('addfile', listener).

If you add lots of files to a Loader from a preload method, it will dispatch this event for each one of them.

nametypeoptionaldescription
keystringNoThe unique key of the file that was added to the Loader.
typestringNoThe [file type]{@link Phaser.Loader.File#type} string of the file that was added to the Loader, i.e. image.
loaderPhaser.Loader.LoaderPluginNoA reference to the Loader Plugin that dispatched this event.
filePhaser.Loader.FileNoA reference to the File which was added to the Loader.

Member of: Phaser.Loader.Events

Source: src/loader/events/ADD_EVENT.js#L7
Since: 3.0.0

COMPLETE

Scope: instance

Description: The Loader Plugin Complete Event.

This event is dispatched when the Loader has fully processed everything in the load queue. By this point every loaded file will now be in its associated cache and ready for use.

Listen to it from a Scene using: this.load.on('complete', listener).

nametypeoptionaldescription
loaderPhaser.Loader.LoaderPluginNoA reference to the Loader Plugin that dispatched this event.
totalCompletenumberNoThe total number of files that successfully loaded.
totalFailednumberNoThe total number of files that failed to load.

Member of: Phaser.Loader.Events

Source: src/loader/events/COMPLETE_EVENT.js#L7
Since: 3.0.0

FILE_COMPLETE

Scope: instance

Description: The File Load Complete Event.

This event is dispatched by the Loader Plugin when any file in the queue finishes loading.

Listen to it from a Scene using: this.load.on('filecomplete', listener).

Make sure you remove this listener when you have finished, or it will continue to fire if the Scene reloads.

You can also listen for the completion of a specific file. See the [FILE_KEY_COMPLETE]{@linkcode Phaser.Loader.Events#event:FILE_KEY_COMPLETE} event.

nametypeoptionaldescription
keystringNoThe key of the file that just loaded and finished processing.
typestringNoThe [file type]{@link Phaser.Loader.File#type} of the file that just loaded, i.e. image.
dataanyYesThe raw data the file contained. If the file was a multi-file, like an atlas or bitmap font, this parameter will be undefined.

Member of: Phaser.Loader.Events

Source: src/loader/events/FILE_COMPLETE_EVENT.js#L7
Since: 3.0.0

FILE_KEY_COMPLETE

Scope: instance

Description: The File Load Complete Event.

This event is dispatched by the Loader Plugin when any file in the queue finishes loading.

It uses a special dynamic event name constructed from the key and type of the file.

For example, if you have loaded an image with a key of monster, you can listen for it using the following:

this.load.on('filecomplete-image-monster', function (key, type, data) {
    // Your handler code
});

Or, if you have loaded a texture atlas with a key of Level1:

this.load.on('filecomplete-atlasjson-Level1', function (key, type, data) {
    // Your handler code
});

Or, if you have loaded a sprite sheet with a key of Explosion and a prefix of GAMEOVER:

this.load.on('filecomplete-spritesheet-GAMEOVERExplosion', function (key, type, data) {
    // Your handler code
});

Make sure you remove your listeners when you have finished, or they will continue to fire if the Scene reloads.

You can also listen for the generic completion of files. See the [FILE_COMPLETE]{@linkcode Phaser.Loader.Events#event:FILE_COMPLETE} event.

nametypeoptionaldescription
keystringNoThe key of the file that just loaded and finished processing.
typestringNoThe [file type]{@link Phaser.Loader.File#type} of the file that just loaded, i.e. image.
dataanyYesThe raw data the file contained. If the file was a multi-file, like an atlas or bitmap font, this parameter will be undefined.

Member of: Phaser.Loader.Events

Source: src/loader/events/FILE_KEY_COMPLETE_EVENT.js#L7
Since: 3.0.0

FILE_LOAD_ERROR

Scope: instance

Description: The File Load Error Event.

This event is dispatched by the Loader Plugin when a file fails to load.

Listen to it from a Scene using: this.load.on('loaderror', listener).

nametypeoptionaldescription
filePhaser.Loader.FileNoA reference to the File which errored during load.

Member of: Phaser.Loader.Events

Source: src/loader/events/FILE_LOAD_ERROR_EVENT.js#L7
Since: 3.0.0

FILE_LOAD

Scope: instance

Description: The File Load Event.

This event is dispatched by the Loader Plugin when a file finishes loading, but before it is processed and added to the internal Phaser caches.

Listen to it from a Scene using: this.load.on('load', listener).

nametypeoptionaldescription
filePhaser.Loader.FileNoA reference to the File which just finished loading.

Member of: Phaser.Loader.Events

Source: src/loader/events/FILE_LOAD_EVENT.js#L7
Since: 3.0.0

FILE_PROGRESS

Scope: instance

Description: The File Load Progress Event.

This event is dispatched by the Loader Plugin during the load of a file, if the browser receives a DOM ProgressEvent and the lengthComputable event property is true. Depending on the size of the file and browser in use, this may, or may not happen.

Listen to it from a Scene using: this.load.on('fileprogress', listener).

nametypeoptionaldescription
filePhaser.Loader.FileNoA reference to the File which errored during load.
percentCompletenumberNoA value between 0 and 1 indicating how 'complete' this file is.

Member of: Phaser.Loader.Events

Source: src/loader/events/FILE_PROGRESS_EVENT.js#L7
Since: 3.0.0

POST_PROCESS

Scope: instance

Description: The Loader Plugin Post Process Event.

This event is dispatched by the Loader Plugin when the Loader has finished loading everything in the load queue. It is dispatched before the internal lists are cleared and each File is destroyed.

Use this hook to perform any last minute processing of files that can only happen once the Loader has completed, but prior to it emitting the complete event.

Listen to it from a Scene using: this.load.on('postprocess', listener).

nametypeoptionaldescription
loaderPhaser.Loader.LoaderPluginNoA reference to the Loader Plugin that dispatched this event.

Member of: Phaser.Loader.Events

Source: src/loader/events/POST_PROCESS_EVENT.js#L7
Since: 3.0.0

PROGRESS

Scope: instance

Description: The Loader Plugin Progress Event.

This event is dispatched when the Loader updates its load progress, typically as a result of a file having completed loading.

Listen to it from a Scene using: this.load.on('progress', listener).

nametypeoptionaldescription
progressnumberNoThe current progress of the load. A value between 0 and 1.

Member of: Phaser.Loader.Events

Source: src/loader/events/PROGRESS_EVENT.js#L7
Since: 3.0.0

START

Scope: instance

Description: The Loader Plugin Start Event.

This event is dispatched when the Loader starts running. At this point load progress is zero.

This event is dispatched even if there aren't any files in the load queue.

Listen to it from a Scene using: this.load.on('start', listener).

nametypeoptionaldescription
loaderPhaser.Loader.LoaderPluginNoA reference to the Loader Plugin that dispatched this event.

Member of: Phaser.Loader.Events

Source: src/loader/events/START_EVENT.js#L7
Since: 3.0.0

Updated on