Handling errors using FusionCharts JavaScript class

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

  • Listening to data-error related events using simple events model
  • Listening to data-error related events using advanced events registration model
  • Using JavaScript debug mode

Let us see below how each can be implemented:

Listening to data-error related events using simple events model

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

  1. FC_NoDataToDisplay : This event is fired when the XML data loaded by chart didn't contain any data to display. It can be used to show an error message to user, or to take a corrective measure.
  2. 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 user, or to take a corrective measure.
  3. FC_DataXMLInvalid : This event is fired when the XML data loaded by chart is invalid. It can be used to show an error message to user, or to take a corrective measure.

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

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

Using 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 NoDataToDisplay, DataLoadError, 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-chart basis.

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

Using JavaScript debug mode

Other than the debug mode of individual FusionCharts SWFs, the has its own debugMode as well. This allows users to watch the chart’s JavaScript activities and debug charts 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 Charts > Using JavaScript page.

Error Code and Description

The table below contains the list of Error codes and the description of each error. [@SB: How and where to use these I need example scenario and example code]

Error Code Nature Description
25081429 param Invalid parameters passed to the getChartAttribute() function.
25081543 param Invalid parameters 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 chart (ExternalInterface function) failed. Check whether the chart has been rendered or whether you have proper Flash Playersecurity settings.
25081621 run This is an error caused when FusionCharts Flash object is sending data to non-existent object while accessing flashVars. This happends when a chart has been disposed from JavaScript, but due to manipulations by any other external script, the chart'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 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 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 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 chart. This is possibly caused when there is an issue while accessing the chart 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 chart's Id.

For example:
var myChart = new FusionCharts('Coulmn3D.swf', 'myChart');
Note that the chart id "myChart" is same as the JS variable name "myChart"
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.