Handling errors using FusionCharts JavaScript Class

FusionMaps XT uses FusionCharts JavaScript Class that takes care of all the products of FusionCharts Suite XT including FusionMaps XT.

The FusionCharts JavaScript Class provides an effective mechanism to debug maps. Errors can be debugged using one of the following methods:

Let us see below how each can be implemented:

Listening to data-error related events using simple events model

The map itself can raise one of three data related errors listed below:

  1. FC_DataLoadError: This event is fired when there was an error in loading data from the specified URL. It can be used to show an error message to the user, or to take a corrective measure.
  2. FC_DataXMLInvalid: This event is fired when the XML data loaded by map is invalid. It can be used to show an error message to the user, or to take a corrective measure.

You can listen to these events and take necessary steps as per the requirement you have. For a sample with detailed description, please go through the Debugging your Maps > Using JavaScript page.

Listening to data-error related events using advanced events registration model

Using the advanced event registration model, you can also listen to the events listed above. The event types or event names for the above mentioned events are DataLoadError, and DataXMLInvalid.

Additionally, FusionCharts JavaScript Library provides two more error events.

  1. Error
  2. Warning

You can listen to the above events globally or on a per-map basis.

For sample implementation and explanations read Debugging your Maps > Using JavaScript page.

Using JavaScript debug mode

Other than the debug mode of individual map SWFs, the map has its own debugMode as well. This allows users to watch the map ’s JavaScript activities and debug maps accordingly. To enable the JavaScript debugMode, you need to write the following lines of code:

FusionCharts.debugMode.enabled(true);
FusionCharts.debugMode.outputTo(console.log);

For details of this debug mode, sample code snippets and explanations read Debugging your Maps > Using JavaScript page.

Error Code and Description

The table below contains the list of Error codes and the description of each error.

Error Code Nature Description
25081429 param Invalid parameters have been passed to the getChartAttribute() function.
25081543 param Invalid parameters have been passed to the getChartData() function. Check whether you are specifying one of the valid data-format strings.
25081617 run Call to a particular method on Flash map (ExternalInterface function) failed. Check whether the map has been rendered or whether you have correct Flash Playersecurity settings.
25081621 run This is an error caused when the FusionCharts Flash object is sending data to non-existent object while accessing flashVars. This happens when a map has been disposed from JavaScript, but due to manipulations by any other external script, the map's HTMLNode is not deleted from the DOM.
25081627 param Invalid parameters (null, undefined, etc) passed to the setDataXML()function.
25081724 param Invalid parameters (null, undefined, etc) passed to the function setDataURL()
25081731 param Invalid parameters (null, undefined, etc) passed to the configureLink() function.
25081803 Runtime Canvas text drawing is not supported in browser. This error occurs when the printManager is activated. Make sure you are not using a very old browser version that does not have full support for HTML5 canvas.
25081807 Runtime There was an error while drawing text on canvas. This error occurs when the printManager is activated. Make sure you are not using a very old browser version that does not have full support for HTML5 canvas.
25081810 Runtime There was an error while drawing canvas. This error occurs when the printManager is created image. Make sure you are not using a very old browser version that does not have full support for HTML5 canvas.
25081816 Runtime printManager is not compatible with your browser. This error occurs when printManager is enabled. Make sure you are not using a very old browser version that does not have support for HTML5 canvas.
25081731 param An invalid value was specified for renderer-name. Make sure you are using one of the valid renderer name strings while using the setCurrentRenderer() function or while specifying "renderer" parameter during FusionCharts construction.
25081733 type An invalid data type was specified for renderer-name. Make sure you are not sending undefined or null to the setCurrentRenderer() function or to "renderer" parameter while FusionCharts construction.
25081840 run An invalid value was specified for renderer-name. Make sure you are using one of the valid renderer name strings while using the setCurrentRenderer() function or while specifying "renderer" parameter during FusionCharts construction.
25081843 param Missing required parameter swfUrl while creating a new FusionCharts object.
25081845 run No active renderer. This is a critical error. Try hard-specifying the renderer name using the setCurrentRenderer() method.
25081850 run Error rendering map. This is possibly caused when there is an issue while accessing the map container HTMLNode element.
25081843 comp IECompatibility variable naming error. This error occurs when you have a JavaScript variable in the global window scope with the same name as that of the map's Id.

For example:
var myMap = new FusionCharts('FCMap_World.swf', 'myMap');
Note that the map id "myMap" is same as the JS variable name "myMap"
03091549 param Unspecified event type specified to the parameter of addEventListener() function. Refer to Event API reference for valid event names.
03091550 param Invalid event type specified to the parameter of removeEventListener() function. Refer to Event API reference for valid event names.
03091559 param Invalid event type specified to the parameter of removeEventListener() function. Refer to Event API reference for valid event names.
03091560 param Unrecognized event type provided to the removeEventListener() function. Refer to Event API reference for valid event names.
03091602 param Invalid event type (null, undefined, etc) provided while event manager raises an event.
03091609 param Invalid parameters passed to the setChartDataUrl() function. Check whether you are specifying one of the valid data-format strings.
03091610 param Invalid parameters passed to the setChartData() function. Check whether you are specifying one of the valid data-format strings.
03091611 param Invalid parameters passed to the setChartData() function. Check whether you are specifying one of the valid data-format strings.