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 1012 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
1023 // PauseBreakpoint | 1023 // PauseBreakpoint |
1024 Breakpoint[] pauseBreakpoints [optional]; | 1024 Breakpoint[] pauseBreakpoints [optional]; |
1025 | 1025 |
1026 // The top stack frame associated with this event, if applicable. | 1026 // The top stack frame associated with this event, if applicable. |
1027 // | 1027 // |
1028 // This is provided for the event kinds: | 1028 // This is provided for the event kinds: |
1029 // PauseBreakpoint | 1029 // PauseBreakpoint |
1030 // PauseInterrupted | 1030 // PauseInterrupted |
1031 // PauseException | 1031 // PauseException |
1032 // | 1032 // |
| 1033 // For PauseInterrupted events, there will be no top frame if the |
| 1034 // isolate is idle (waiting in the message loop). |
| 1035 // |
1033 // For the Resume event, the top frame is provided at | 1036 // For the Resume event, the top frame is provided at |
1034 // all times except for the initial resume event that is delivered | 1037 // all times except for the initial resume event that is delivered |
1035 // when an isolate begins execution. | 1038 // when an isolate begins execution. |
1036 Frame topFrame [optional]; | 1039 Frame topFrame [optional]; |
1037 | 1040 |
1038 // The exception associated with this event, if this is a | 1041 // The exception associated with this event, if this is a |
1039 // PauseException event. | 1042 // PauseException event. |
1040 @Instance exception [optional]; | 1043 @Instance exception [optional]; |
1041 | 1044 |
1042 // An array of bytes, encoded as a base64 string. | 1045 // An array of bytes, encoded as a base64 string. |
(...skipping 1070 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
2113 ## Revision History | 2116 ## Revision History |
2114 | 2117 |
2115 version | comments | 2118 version | comments |
2116 ------- | -------- | 2119 ------- | -------- |
2117 1.0 draft 1 | initial revision | 2120 1.0 draft 1 | initial revision |
2118 1.1 | Describe protocol version 2.0. | 2121 1.1 | Describe protocol version 2.0. |
2119 1.2 | Describe protocol version 3.0. Added UnresolvedSourceLocation. Added Sen
tinel return to getIsolate. | 2122 1.2 | Describe protocol version 3.0. Added UnresolvedSourceLocation. Added Sen
tinel return to getIsolate. |
2120 | 2123 |
2121 | 2124 |
2122 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 2125 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
OLD | NEW |