OLD | NEW |
1 # Dart VM Service Protocol 3.0 | 1 # Dart VM Service Protocol 3.0 |
2 | 2 |
3 > Please post feedback to the [observatory-discuss group][discuss-list] | 3 > Please post feedback to the [observatory-discuss group][discuss-list] |
4 | 4 |
5 This document describes of _version 3.0_ of the Dart VM Service Protocol. This | 5 This document describes of _version 3.0_ of the Dart VM Service Protocol. This |
6 protocol is used to communicate with a running Dart Virtual Machine. | 6 protocol is used to communicate with a running Dart Virtual Machine. |
7 | 7 |
8 To use the Service Protocol, start the VM with the *--observe* flag. | 8 To use the Service Protocol, start the VM with the *--observe* flag. |
9 The VM will start a webserver which services protocol requests via WebSocket. | 9 The VM will start a webserver which services protocol requests via WebSocket. |
10 It is possible to make HTTP (non-WebSocket) requests, | 10 It is possible to make HTTP (non-WebSocket) requests, |
(...skipping 20 matching lines...) Expand all Loading... |
31 - [evaluateInFrame](#evaluateinframe) | 31 - [evaluateInFrame](#evaluateinframe) |
32 - [getFlagList](#getflaglist) | 32 - [getFlagList](#getflaglist) |
33 - [getIsolate](#getisolate) | 33 - [getIsolate](#getisolate) |
34 - [getObject](#getobject) | 34 - [getObject](#getobject) |
35 - [getStack](#getstack) | 35 - [getStack](#getstack) |
36 - [getVersion](#getversion) | 36 - [getVersion](#getversion) |
37 - [getVM](#getvm) | 37 - [getVM](#getvm) |
38 - [pause](#pause) | 38 - [pause](#pause) |
39 - [removeBreakpoint](#removebreakpoint) | 39 - [removeBreakpoint](#removebreakpoint) |
40 - [resume](#resume) | 40 - [resume](#resume) |
| 41 - [setExceptionPauseMode](#setexceptionpausemode) |
41 - [setLibraryDebuggable](#setlibrarydebuggable) | 42 - [setLibraryDebuggable](#setlibrarydebuggable) |
42 - [setName](#setname) | 43 - [setName](#setname) |
43 - [setVMName](#setvmname) | 44 - [setVMName](#setvmname) |
44 - [streamCancel](#streamcancel) | 45 - [streamCancel](#streamcancel) |
45 - [streamListen](#streamlisten) | 46 - [streamListen](#streamlisten) |
46 - [Public Types](#public-types) | 47 - [Public Types](#public-types) |
47 - [BoundField](#boundfield) | 48 - [BoundField](#boundfield) |
48 - [BoundVariable](#boundvariable) | 49 - [BoundVariable](#boundvariable) |
49 - [Breakpoint](#breakpoint) | 50 - [Breakpoint](#breakpoint) |
50 - [Class](#class) | 51 - [Class](#class) |
(...skipping 566 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
617 single-stepping to use. | 618 single-stepping to use. |
618 | 619 |
619 step | meaning | 620 step | meaning |
620 ---- | ------- | 621 ---- | ------- |
621 Into | Single step, entering function calls | 622 Into | Single step, entering function calls |
622 Over | Single step, skipping over function calls | 623 Over | Single step, skipping over function calls |
623 Out | Single step until the current function exits | 624 Out | Single step until the current function exits |
624 | 625 |
625 See [Success](#success), [StepOption](#StepOption). | 626 See [Success](#success), [StepOption](#StepOption). |
626 | 627 |
| 628 ### setExceptionPauseMode |
| 629 |
| 630 ``` |
| 631 Success setExceptionPauseMode(string isolateId, |
| 632 ExceptionPauseMode mode) |
| 633 ``` |
| 634 |
| 635 The _setExceptionPauseMode_ RPC is used to control if an isolate pauses when |
| 636 an exception is thrown. |
| 637 |
| 638 mode | meaning |
| 639 ---- | ------- |
| 640 None | Do not pause isolate on thrown exceptions |
| 641 Unhandled | Pause isolate on unhandled exceptions |
| 642 All | Pause isolate on all thrown exceptions |
| 643 |
| 644 |
627 ### setLibraryDebuggable | 645 ### setLibraryDebuggable |
628 | 646 |
629 ``` | 647 ``` |
630 Success setLibraryDebuggable(string isolateId, | 648 Success setLibraryDebuggable(string isolateId, |
631 string libraryId, | 649 string libraryId, |
632 bool isDebuggable) | 650 bool isDebuggable) |
633 ``` | 651 ``` |
634 | 652 |
635 The _setLibraryDebuggable_ RPC is used to enable or disable whether | 653 The _setLibraryDebuggable_ RPC is used to enable or disable whether |
636 breakpoints and stepping work for a given library. | 654 breakpoints and stepping work for a given library. |
(...skipping 1388 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
2025 | 2043 |
2026 ### Stack | 2044 ### Stack |
2027 | 2045 |
2028 ``` | 2046 ``` |
2029 class Stack extends Response { | 2047 class Stack extends Response { |
2030 Frame[] frames; | 2048 Frame[] frames; |
2031 Message[] messages; | 2049 Message[] messages; |
2032 } | 2050 } |
2033 ``` | 2051 ``` |
2034 | 2052 |
| 2053 ### ExceptionPauseMode |
| 2054 |
| 2055 ``` |
| 2056 enum ExceptionPauseMode { |
| 2057 None, |
| 2058 Unhandled, |
| 2059 All, |
| 2060 } |
| 2061 ``` |
| 2062 |
| 2063 An _ExceptionPauseMode_ indicates how the isolate pauses when an exception |
| 2064 is thrown. |
| 2065 |
2035 ### StepOption | 2066 ### StepOption |
2036 | 2067 |
2037 ``` | 2068 ``` |
2038 enum StepOption { | 2069 enum StepOption { |
2039 Into, | 2070 Into, |
2040 Over, | 2071 Over, |
2041 Out | 2072 Out |
2042 } | 2073 } |
2043 ``` | 2074 ``` |
2044 | 2075 |
(...skipping 120 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
2165 ## Revision History | 2196 ## Revision History |
2166 | 2197 |
2167 version | comments | 2198 version | comments |
2168 ------- | -------- | 2199 ------- | -------- |
2169 1.0 | initial revision | 2200 1.0 | initial revision |
2170 2.0 | Describe protocol version 2.0. | 2201 2.0 | Describe protocol version 2.0. |
2171 3.0 | Describe protocol version 3.0. Added UnresolvedSourceLocation. Added Sen
tinel return to getIsolate. Add AddedBreakpointWithScriptUri. Removed Isolate.
entry. The type of VM.pid was changed from string to int. Added VMUpdate events
. | 2202 3.0 | Describe protocol version 3.0. Added UnresolvedSourceLocation. Added Sen
tinel return to getIsolate. Add AddedBreakpointWithScriptUri. Removed Isolate.
entry. The type of VM.pid was changed from string to int. Added VMUpdate events
. |
2172 | 2203 |
2173 | 2204 |
2174 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 2205 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
OLD | NEW |