jsdIDebuggerService Interface

 Force the engine to perform garbage collection.

void GC()

 Same as insertFilter, except always add to the end of the list.

void appendFilter(in jsdIFilter filter)

 Clear all breakpoints in all scripts.

void clearAllBreakpoints()

 Clear the list of filters.

void clearFilters()

 Clear profile data for all scripts.

void clearProfileData()

 Output dump of JS heap.

 @param fileName Filename to dump the heap into.

void dumpHeap(in AUTF8String fileName)

 Push a new network queue, and enter a new UI event loop.
 @param callback jsdINestCallback instance to be called back after the
                 network queue has been pushed, but before the
                 UI loop starts.
 @return depth returns the current number of times the event loop has been
               nested.  your code can use it for sanity checks.

unsigned long enterNestedEventLoop(in jsdINestCallback callback)

 Enumerate all known contexts.

void enumerateContexts(in jsdIContextEnumerator enumerator)

 Enumerate registered filters.  This routine refreshes each filter before
 passing them on to the enumeration function.  Calling this with a null
 |enumerator| is equivalent to jsdIService::refreshFilters.

 @param enumerator jsdIFilterEnumerator instance to be called back for the
                   enumeration.

void enumerateFilters(in jsdIFilterEnumerator enumerator)

 Enumerate all scripts the debugger knows about.  Any scripts created
 before you turned the debugger on, or after turning the debugger off
 will not be available unless the autostart perf is set.

 @param enumerator jsdIScriptEnumerator instance to be called back for
                   the enumeration.

void enumerateScripts(in jsdIScriptEnumerator enumerator)

 Exit the current nested event loop after the current iteration completes,
 and pop the network event queue.

 @return depth returns the current number of times the event loop has been
               nested.  your code can use it for sanity checks.

unsigned long exitNestedEventLoop()

 Adds an execution hook filter.  These filters are consulted each time one
 of the jsdIExecutionHooks is about to be called.  Filters are matched in
 a first in, first compared fashion.  The first filter to match determines
 whether or not the hook is called.  Use swapFilter to reorder existing
 filters, and removeFilter to remove them.

 If |filter| is already present this method throws NS_ERROR_INVALID_ARG.

 @param filter Object representing the filter to add.
 @param after  Insert |filter| after this one.  Pass null to insert at
               the beginning.

void insertFilter(in jsdIFilter filter, in jsdIFilter after)

 Turn the debugger off.  This will invalidate all of your jsdIEphemeral
 derived objects, and clear all of your breakpoints.  In theory you
 should be able to turn the debugger back on at some later time without
 any problems.

void off()

 Turn on the debugger.  This function should only be called from JavaScript
 code.  The debugger will be enabled on the runtime the call is made on,
 as determined by nsIXPCNativeCallContext.

void on()

 Turn on the debugger for a given runtime.

 @param rt The runtime you want to debug.  You cannot turn the debugger
           on for multiple runtimes.

[noscript] void onForRuntime(in JSRuntime rt)

 Temporarily disable the debugger.  Hooks will not be called while the
 debugger is paused.  Multiple calls to pause will increase the "pause
 depth", and equal number of unPause calles must be made to resume
 normal debugging.

 @return depth Number of times pause has been called since the debugger
               has been unpaused.

unsigned long pause()

 Force the debugger to resync its internal filter cache with the
 actual values in the jsdIFilter objects.  To refresh a single filter
 use jsdIService::swapFilters.  This method is equivalent to
 jsdIService::enumerateFilters with a null enumerator.

void refreshFilters()

 Remove a filter.

 If |filter| is not present this method throws NS_ERROR_INVALID_ARG.

 @param filter Object representing the filter to remove.  Must be the exact
 object passed to addFilter, not just a new object with the same
 properties.

void removeFilter(in jsdIFilter filter)

 Swap position of two filters.
 
 If |filter_a| is not present, this method throws NS_ERROR_INVALID_ARG.
 If |filter_b| is not present, filter_a is replaced by filter_b.
 If |filter_a| == |filter_b|, then filter is refreshed.

void swapFilters(in jsdIFilter filter_a, in jsdIFilter filter_b)

 Undo a pause.

 @return depth The number of remaining pending pause calls.

unsigned long unPause()

 When called from JavaScript, this method returns the jsdIValue wrapper
 for the given value.  If a wrapper does not exist one will be created.
 When called from another language this method returns an xpconnect
 defined error code.

jsdIValue wrapValue()