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