voltmx.lang Namespace

Functions

The voltmx.lang namespace provides the following functions.

voltmx.lang.getUncaughtExceptionHandler

The voltmx.lang.getUncaughtExceptionHandler API retrieves the reference to a JavaScript function that is currently set as an exception handler for all uncaught exceptions.

Syntax

voltmx.lang.getUncaughtExceptionHandler()

Example

var funtionObject = voltmx.lang.getUncaughtExceptionHandler();

Return Values

JavaScript value containing the function reference.

Platform Availability

Available in iOS and Android platforms.

voltmx.lang.setUncaughtExceptionHandler

The voltmx.lang.setUncaughtExceptionHandler API sets a JavaScript function as an exception handler for all uncaught exceptions. The JavaScript function takes one argument that is the JavaScript exception object. A developer can query the properties of this object like any other JavaScript object.

Note: In Android platform ,the exceptionObject contains only stack and message properties.

Syntax

voltmx.lang.setUncaughtExceptionHandler([JavaScript Function Object](#JSFunctionObject))

Input Parameters

Parameter	Description
JavaScript Function object [Function] - Mandatory	Call back function that is called when an uncaught exception is raised by JavaScript engine.

Following is the signature of the function object: 

Function <FuncName> ( exceptionObject)  
<handler code>  
End  

Example

function uncaughtExceptionHandler(exceptionObject) {
    // Converting exception object into a readable string
    var exceptionString = "";

    if ("sourceURL" in exceptionObject) {
        exceptionString += exceptionObject.sourceURL;
    }
    if ("line" in exceptionObject) {
        exceptionString += " line # " + exceptionObject.line;
    }
    if ("message" in exceptionObject) {
        exceptionString += " : " + exceptionObject.message;
    }

    //Logging the exception string to console
    voltmx.print("Unhandled Exception:" + exceptionString);
}

voltmx.lang.setUncaughtExceptionHandler(uncaughtExceptionHandler);

Return Values

None

Platform Availability

Available in iOS and Android platforms.