|
1 /* This Source Code Form is subject to the terms of the Mozilla Public |
|
2 * License, v. 2.0. If a copy of the MPL was not distributed with this |
|
3 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ |
|
4 |
|
5 #include "nsISupports.idl" |
|
6 |
|
7 /** |
|
8 * Utilities for integrating the JSInspector object into an XPCOM |
|
9 * application. |
|
10 */ |
|
11 [scriptable, uuid(6758d0d7-e96a-4c5c-bca8-3bcbe5a15943)] |
|
12 interface nsIJSInspector : nsISupports |
|
13 { |
|
14 /** |
|
15 * Process the thread's event queue until exit. |
|
16 * |
|
17 * @param requestor A token the requestor passes to identify the pause. |
|
18 * |
|
19 * @return depth Returns the number of times the event loop |
|
20 * has been nested using this API. |
|
21 */ |
|
22 unsigned long enterNestedEventLoop(in jsval requestor); |
|
23 |
|
24 /** |
|
25 * Exits the current nested event loop. |
|
26 * |
|
27 * @return depth The number of nested event loops left after |
|
28 * exiting the event loop. |
|
29 * |
|
30 * @throws NS_ERROR_FAILURE if there are no nested event loops |
|
31 * running. |
|
32 */ |
|
33 unsigned long exitNestedEventLoop(); |
|
34 |
|
35 readonly attribute unsigned long eventLoopNestLevel; |
|
36 |
|
37 /** |
|
38 * The token provided by the actor that last requested a nested event loop. |
|
39 */ |
|
40 readonly attribute jsval lastNestRequestor; |
|
41 }; |