Get the current pending exception for a given JSContext.

Syntax

bool
JS_GetPendingException(JSContext *cx, JS::MutableHandleValue vp);
Name Type Description
cx JSContext * Pointer to the JS context in which the exception was thrown. Requires request. In a JS_THREADSAFE build, the caller must be in a request on this JSContext.
vp JS::MutableHandleValue Out parameter. On success, *vp receives the current pending exception.

Description

If an exception has been thrown in the context cx, and it has not yet been caught or cleared, JS_GetPendingException stores the exception object in *vp and returns true.

Otherwise, it returns false, and the value left in *vp is undefined.

See examples in the JSAPI Phrasebook.

See Also