Core JavaScript 1.5 Reference - JSException – EFS

Core JavaScript Reference 1.5

JSException

The public class JSException extends RuntimeException .

   java.lang.Object
   |
   +----java.lang.Throwable
            |
            +----java.lang.Exception
                     |
                     +----java.lang.RuntimeException
                                 |
                                 +----netscape.javascript.JSException

Description
JSException is an exception which is thrown when JavaScript code returns an error.

Constructor Summary
The netscape.javascript.JSException class has the following constructors:

Constructor	Description
JSException	Deprecated constructors optionally let you specify a detail message and other information.

Method Summary
The netscape.javascript.JSException class has the following methods:

Method	Description
getWrappedException	Instance method getWrappedException.
getWrappedExceptionType	Instance method getWrappedExceptionType returns the int mapping of the type of the wrappedException object.

The following sections show the declaration and usage of the constructors and method.

Backward Compatibility

JavaScript 1.1 through 1.3. JSException had three public constructors which optionally took a string argument, specifying the detail message or other information for the exception. The getWrappedException method was not available.

JSException

Constructors, deprecated in JavaScript 1.4. Constructs a JSException with an optional detail message.

Declaration

   1. public JSException()  

   2. public JSException(String s)  

   3. public JSException(String s,
   String filename,
   int lineno,
   String source,
   int tokenIndex)

Arguments

s	The detail message.
filename	The URL of the file where the error occurred, if possible.
lineno	The line number if the file, if possible.
source	The string containing the JavaScript code being evaluated.
tokenIndex	The index into the source string where the error occurred.

getWrappedException

Instance method getWrappedException .

Declaration

 public Object getWrappedException()

Description
getWrappedException() returns an object that represents the value that the JavaScript actually threw. JavaScript can throw any type of value. Use getWrappedException() to determine what kind of value the Object return type represents.

getWrappedExceptionType

Instance method getWrappedExceptionType .

Declaration

  public int getWrappedExceptionType()

Description
getWrappedExceptionType() returns an int that matches one of the following static int s declared by the JSException class:

EXCEPTION_TYPE_EMPTY

EXCEPTION_TYPE_VOID

EXCEPTION_TYPE_OBJECT

EXCEPTION_TYPE_FUNCTION

EXCEPTION_TYPE_STRING

EXCEPTION_TYPE_NUMBER

EXCEPTION_TYPE_BOOLEAN

Previous Contents Index Next

Last Updated September 28, 2000