mozilla
Your Search Results

    JS_ReportPendingException

    Forward the current pending exception in a given JSContext to the current JSErrorReporter callback.

    Syntax

    bool
    JS_ReportPendingException(JSContext *cx);
    
    Name Type Description
    cx JSContext * The context in which the exception was thrown. Requires request. In a JS_THREADSAFE build, the caller must be in a request on this JSContext.

    Description

    If an exception is pending in the context cx, JS_ReportPendingException converts the exception to a string and reports it to the current error reporter.

    On success, it clears the exception as though by calling JS_ClearPendingException and returns true. If no exception is pending, or if a second error occurs while trying to report the first one, it returns false.

    This function can be used to catch exceptions thrown from scripts and send them to the error reporter to be logged or ignored. Note that certain JSAPI functions automatically do this for uncaught exceptions; see "Automatic handling of uncaught exceptions" in the JSAPI User Guide.

    See Also

    Document Tags and Contributors

    Contributors to this page: fscholz, Jorend, arai
    Last updated by: arai,
    Hide Sidebar