kony.lang Namespace

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

Syntax

kony.lang.getUncaughtExceptionHandler();

Example

var funtionObject = kony.lang.getUncaughtExceptionHandler();

Return Values

JavaScript value containing the function reference.

Platform Availability

• iOS
• Android

The kony.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

kony.lang.setUncaughtExceptionHandler(JavaScript Function Object);

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
    kony.print("Unhandled Exception:" + exceptionString);
}

kony.lang.setUncaughtExceptionHandler(uncaughtExceptionHandler);

Return Values

None

Platform Availability

• iOS
• Android