Clear the currently pending exception in a context.
Syntax
void JS_ClearPendingException(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
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 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 false
without building and throwing an exception object. Use JS_IsExceptionPending
or JS_GetPendingException
to check for a pending exception.
See examples in the JSAPI Phrasebook.