mozilla
Your Search Results

    JS_ReportError

    Create a formatted error or warning message to pass to a user-defined error reporting function. This function can also raise a JavaScript exception which a currently executing script can catch.

    Syntax

    void
    JS_ReportError(JSContext *cx, const char *format, ...);
    
    bool
    JS_ReportWarning(JSContext *cx, const char *format, ...);
    
    Name Type Description
    cx JSContext * Pointer to a JS context from which to derive runtime information. Requires request. In a JS_THREADSAFE build, the caller must be in a request on this JSContext.
    format const char * Format string to convert into an error message using JS_vsmprintf.
    ... ... Error message variables to insert into the format string.

    Description

    JS_ReportError is the simplest JSAPI function for reporting errors. First it builds an error message from the given sprintf-style format string and any additional arguments passed after it. The resulting error message is passed to the context's JSErrorReporter callback, if any.

    If the caller is in a JSAPI callback, JS_ReportError also creates a new JavaScript Error object and sets it to be the pending exception on cx. The callback must then return JS_FALSE to cause the exception to be propagated to the calling script.

    An example is shown in the JSAPI Phrasebook.

    For internationalization, use JS_ReportErrorNumber instead. To report an out-of-memory error, use JS_ReportOutOfMemory.

    See Also

    Document Tags and Contributors

    Contributors to this page: fscholz, Dria, arai, MMondor, Waldo, meh., Jorend
    Last updated by: arai,
    Hide Sidebar