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 159 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
170 In addition the the [error codes](http://www.jsonrpc.org/specification#error_obj
ect) | 170 In addition the the [error codes](http://www.jsonrpc.org/specification#error_obj
ect) |
171 specified in the JSON-RPC spec, we use the following application specific error
codes: | 171 specified in the JSON-RPC spec, we use the following application specific error
codes: |
172 | 172 |
173 code | message | meaning | 173 code | message | meaning |
174 ---- | ------- | ------- | 174 ---- | ------- | ------- |
175 100 | Feature is disabled | The operation is unable to complete because a featur
e is disabled | 175 100 | Feature is disabled | The operation is unable to complete because a featur
e is disabled |
176 101 | VM must be paused | This operation is only valid when the VM is paused | 176 101 | VM must be paused | This operation is only valid when the VM is paused |
177 102 | Cannot add breakpoint | The VM is unable to add a breakpoint at the specif
ied line or function | 177 102 | Cannot add breakpoint | The VM is unable to add a breakpoint at the specif
ied line or function |
178 103 | Stream already subscribed | The client is already subscribed to the specif
ied _streamId_ | 178 103 | Stream already subscribed | The client is already subscribed to the specif
ied _streamId_ |
179 104 | Stream not subscribed | The client is not subscribed to the specified _str
eamId_ | 179 104 | Stream not subscribed | The client is not subscribed to the specified _str
eamId_ |
| 180 105 | Isolate must be runnable | This operation cannot happen until the isolate
is runnable |
180 | 181 |
181 | 182 |
182 | 183 |
183 | 184 |
184 ## Events | 185 ## Events |
185 | 186 |
186 By using the [streamListen](#streamlisten) and [streamCancel](#streamcancel) RPC
s, a client may | 187 By using the [streamListen](#streamlisten) and [streamCancel](#streamcancel) RPC
s, a client may |
187 request to be notified when an _event_ is posted to a specific | 188 request to be notified when an _event_ is posted to a specific |
188 _stream_ in the VM. Every stream has an associated _stream id_ which | 189 _stream_ in the VM. Every stream has an associated _stream id_ which |
189 is used to name that stream. | 190 is used to name that stream. |
(...skipping 2123 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
2313 ## Revision History | 2314 ## Revision History |
2314 | 2315 |
2315 version | comments | 2316 version | comments |
2316 ------- | -------- | 2317 ------- | -------- |
2317 1.0 | initial revision | 2318 1.0 | initial revision |
2318 2.0 | Describe protocol version 2.0. | 2319 2.0 | Describe protocol version 2.0. |
2319 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
. Add offset and count parameters to getObject() and offset and count fields to
Instance. Added ServiceExtensionAdded event. | 2320 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
. Add offset and count parameters to getObject() and offset and count fields to
Instance. Added ServiceExtensionAdded event. |
2320 | 2321 |
2321 | 2322 |
2322 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 2323 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
OLD | NEW |