Class: JsonManager

JsonManager

new gdjs.JsonManager(resources)

JsonManager loads json files (using XMLHttpRequest), using the "json" resources registered in the game resources.

Contrary to audio/fonts, json files are loaded asynchronously, when requested. You should properly handle errors, and give the developer/player a way to know that loading failed.

Name Type Description
resources Array.<Object>

The resources data of the game.

Methods

getLoadedJson(resourceName){Object}

Get the object for the given resource that is already loaded (preloaded or loaded with loadJson). If the resource is not loaded, null will be returned.

Name Type Description
resourceName string

The name of the json resource.

Returns:
Type Description
Object the content of the json resource, if loaded. null otherwise.

isJsonLoaded(resourceName){boolean}

Check if the given json resource was loaded (preloaded or loaded with loadJson).

Name Type Description
resourceName string

The name of the json resource.

Returns:
Type Description
boolean true if the content of the json resource is loaded. false otherwise.

loadJson(resourceName, callback)

Request the json file from the given resource name. This method is asynchronous. When loaded, the callback is called with the error (null if none) and the loaded json (a JS Object).

Name Type Description
resourceName string

The resource pointing to the json file to load.

callback JsonManagerRequestCallback

The callback function called when json is loaded (or an error occured).

preloadJsons(onProgress, onComplete)

Request all the json resources to be preloaded (unless they are marked as not preloaded).

Name Type Description
onProgress JsonManagerOnProgressCallback

The function called after each json is loaded.

onComplete JsonManagerOnCompleteCallback

The function called when all jsons are loaded.