| OLD | NEW |
| 1 # Dart VM Service Protocol 3.0 | 1 # Dart VM Service Protocol 3.3 |
| 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.3_ 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, |
| 11 but this does not allow access to VM _events_ and is not documented | 11 but this does not allow access to VM _events_ and is not documented |
| 12 here. | 12 here. |
| 13 | 13 |
| 14 The Service Protocol uses [JSON-RPC 2.0][]. | 14 The Service Protocol uses [JSON-RPC 2.0][]. |
| 15 | 15 |
| (...skipping 1797 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 1813 string number; | 1813 string number; |
| 1814 | 1814 |
| 1815 // A name identifying this isolate. Not guaranteed to be unique. | 1815 // A name identifying this isolate. Not guaranteed to be unique. |
| 1816 string name; | 1816 string name; |
| 1817 | 1817 |
| 1818 // The time that the VM started in milliseconds since the epoch. | 1818 // The time that the VM started in milliseconds since the epoch. |
| 1819 // | 1819 // |
| 1820 // Suitable to pass to DateTime.fromMillisecondsSinceEpoch. | 1820 // Suitable to pass to DateTime.fromMillisecondsSinceEpoch. |
| 1821 int startTime; | 1821 int startTime; |
| 1822 | 1822 |
| 1823 // Is the isolate in a runnable state? |
| 1824 bool runnable; |
| 1825 |
| 1823 // The number of live ports for this isolate. | 1826 // The number of live ports for this isolate. |
| 1824 int livePorts; | 1827 int livePorts; |
| 1825 | 1828 |
| 1826 // Will this isolate pause when exiting? | 1829 // Will this isolate pause when exiting? |
| 1827 bool pauseOnExit; | 1830 bool pauseOnExit; |
| 1828 | 1831 |
| 1829 // The last pause event delivered to the isolate. If the isolate is | 1832 // The last pause event delivered to the isolate. If the isolate is |
| 1830 // running, this will be a resume event. | 1833 // running, this will be a resume event. |
| 1831 Event pauseEvent; | 1834 Event pauseEvent; |
| 1832 | 1835 |
| (...skipping 478 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 2311 } | 2314 } |
| 2312 ``` | 2315 ``` |
| 2313 | 2316 |
| 2314 ## Revision History | 2317 ## Revision History |
| 2315 | 2318 |
| 2316 version | comments | 2319 version | comments |
| 2317 ------- | -------- | 2320 ------- | -------- |
| 2318 1.0 | initial revision | 2321 1.0 | initial revision |
| 2319 2.0 | Describe protocol version 2.0. | 2322 2.0 | Describe protocol version 2.0. |
| 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. | 2323 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. |
| 2321 | 2324 3.1 | Add the getSourceReport RPC. The getObject RPC now accepts offset and cou
nt for string objects. String objects now contain length, offset, and count pro
perties. |
| 2325 3.2 | Isolate objects now include the runnable bit and many debugger related RPC
s will return an error if executed on an isolate before it is runnable. |
| 2326 3.3 | A patched protocol version used in stable 1.14.2, containing the addition
in 3.2 but not the addition in 3.1. |
| 2322 | 2327 |
| 2323 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 2328 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
| OLD | NEW |