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