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, ...);

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

• MXR ID Search for JS_ReportError
• MXR ID Search for JS_ReportWarning