Obviously this stuff is almost entirely undocumented.
See the implementation of the trap, untrap, watch, unwatch, line2pc, and pc2line functions in js/src/shell/js.cpp. Also the (scant) comments in js/src/jsdbgapi.h.
Breakpoints
JS_SetTrapJS_GetTrapOpcodeJS_ClearTrapJS_ClearScriptTrapsJS_ClearAllTrapsJS_HandleTrapJS_SetInterruptJS_ClearInterrupt
Watchpoints
Inspecting the stack
JS_PCToLineNumberJS_LineNumberToPCJS_GetFunctionScriptJS_GetFunctionNativeJS_GetFunctionFastNativeJS_GetScriptPrincipals
- typedef
JSStackFrame JS_FrameIteratorJS_GetFrameScriptJS_GetFramePCJS_GetScriptedCallerJS_StackFramePrincipalsJS_EvalFramePrincipalsJS_GetFrameAnnotationJS_SetFrameAnnotationJS_GetFramePrincipalArrayJS_IsNativeFrameJS_GetFrameObjectJS_GetFrameScopeChainJS_GetFrameCallObjectJS_GetFrameThisJS_GetFrameFunctionJS_GetFrameFunctionObjectJS_IsConstructorFrameJS_IsDebuggerFrameJS_GetFrameReturnValueJS_SetFrameReturnValueJS_GetFrameCalleeObject
Evaluating debug code
Examining object properties
- typedef
JSPropertyDesc
JSPD_ENUMERATEJSPD_READONLYJSPD_PERMANENTJSPD_ALIASJSPD_ARGUMENTJSPD_VARIABLEJSPD_EXCEPTIONJSPD_ERROR
- typedef
JSPropertyDescArray
Hooks
JS_SetDebuggerHandlerJS_SetSourceHandlerJS_SetExecuteHookJS_SetCallHookJS_SetObjectHookJS_SetThrowHookJS_SetDebugErrorHookJS_SetNewScriptHookJS_SetDestroyScriptHook
Memory usage
System objects
Profiling
These functions can be used to profile a SpiderMonkey application using the Mac profiler, Shark. See Profiling JavaScript with Shark.
The following JSNative functions can be used to expose the above four APIs to scripts.