Clear the currently pending exception in a context.
void JS_ClearPendingException(JSContext *cx);
||The context in which the exception was thrown.
Requires request. In a
JS_ClearPendingException cancels the currently pending exception in
cx, if any. (There is a pending exception if the most recently thrown exception in
cx has not yet been caught or cleared.)
When any JSAPI call fails with an exception, the caller must either use
JS_ClearPendingException to catch the exception; or return
JS_FALSE to allow the exception to propagate to the caller.
Note that a JSAPI failure does not necessarily indicate that an exception is pending. Many JSAPI functions can simply report an error and return
JS_FALSE without building and throwing an exception object. Use
JS_GetPendingException to check for a pending exception.
See examples in the JSAPI Phrasebook.