WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

jsdIExecutionHook

IID:9a7b6ad0-1dd1-11b2-a789-fcfae96356a2
Inherits From:nsISupports

Constants

PRUint32 TYPE_INTERRUPTED = 0
Execution stopped by a trap instruction (i.e. breakoint.)
PRUint32 TYPE_BREAKPOINT = 1
Error handler returned an "invoke debugger" value.
PRUint32 TYPE_DEBUG_REQUESTED = 2
Debugger keyword encountered.
PRUint32 TYPE_DEBUGGER_KEYWORD = 3
Exception was thrown.
PRUint32 TYPE_THROW = 4
Indicates unrecoverable error processing the hook. This will cause the script being executed to be aborted without raising a JavaScript exception.
PRUint32 RETURN_HOOK_ERROR = 0
Continue processing normally. This is the "do nothing special" return value for all hook types *except* TYPE_THROW. Returning RETURN_CONTINUE from TYPE_THROW cause the exception to be ignored. Return RETURN_CONTINUE_THROW to continue exception processing from TYPE_THROW hooks.
PRUint32 RETURN_CONTINUE = 1
Same effect as RETURN_HOOK_ERROR.
PRUint32 RETURN_ABORT = 2
Return the value of the val parameter.
PRUint32 RETURN_RET_WITH_VAL = 3
Throw the value of the val parameter.
PRUint32 RETURN_THROW_WITH_VAL = 4
Continue the current throw.
PRUint32 RETURN_CONTINUE_THROW = 5

Methods

PRUint32 onExecute ( jsdIStackFrame frame , PRUint32 type , inout jsdIValue val )

PRUint32 onExecute ( jsdIStackFrame frame , PRUint32 type , inout jsdIValue val )

Arguments:
frame: A jsdIStackFrame object representing the bottom stack frame.
type: One of the jsdIExecutionHook::TYPE_ constants.
val: in - Current exception (if any) when this method is called. out - If you return RETURN_THROW_WITH_VAL, value to be thrown. If you return RETURN_RET_WITH_VAL, value to return. All other return values, not significant.

References

This interface is the type of the following properties:

jsdIDebuggerService.breakpointHook, jsdIDebuggerService.debugHook, jsdIDebuggerService.debuggerHook, jsdIDebuggerService.interruptHook, jsdIDebuggerService.throwHook

Reference documentation is generated from Mozilla's source.