OLD | NEW |
1 # Dart VM Service Protocol 3.1 | 1 # Dart VM Service Protocol 3.2 |
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.1_ of the Dart VM Service Protocol. This | 5 This document describes of _version 3.2_ 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 1858 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
1874 string number; | 1874 string number; |
1875 | 1875 |
1876 // A name identifying this isolate. Not guaranteed to be unique. | 1876 // A name identifying this isolate. Not guaranteed to be unique. |
1877 string name; | 1877 string name; |
1878 | 1878 |
1879 // The time that the VM started in milliseconds since the epoch. | 1879 // The time that the VM started in milliseconds since the epoch. |
1880 // | 1880 // |
1881 // Suitable to pass to DateTime.fromMillisecondsSinceEpoch. | 1881 // Suitable to pass to DateTime.fromMillisecondsSinceEpoch. |
1882 int startTime; | 1882 int startTime; |
1883 | 1883 |
| 1884 // Is the isolate in a runnable state? |
| 1885 bool runnable; |
| 1886 |
1884 // The number of live ports for this isolate. | 1887 // The number of live ports for this isolate. |
1885 int livePorts; | 1888 int livePorts; |
1886 | 1889 |
1887 // Will this isolate pause when exiting? | 1890 // Will this isolate pause when exiting? |
1888 bool pauseOnExit; | 1891 bool pauseOnExit; |
1889 | 1892 |
1890 // The last pause event delivered to the isolate. If the isolate is | 1893 // The last pause event delivered to the isolate. If the isolate is |
1891 // running, this will be a resume event. | 1894 // running, this will be a resume event. |
1892 Event pauseEvent; | 1895 Event pauseEvent; |
1893 | 1896 |
(...skipping 570 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
2464 ``` | 2467 ``` |
2465 | 2468 |
2466 ## Revision History | 2469 ## Revision History |
2467 | 2470 |
2468 version | comments | 2471 version | comments |
2469 ------- | -------- | 2472 ------- | -------- |
2470 1.0 | initial revision | 2473 1.0 | initial revision |
2471 2.0 | Describe protocol version 2.0. | 2474 2.0 | Describe protocol version 2.0. |
2472 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. | 2475 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. |
2473 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. | 2476 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. |
| 2477 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. |
2474 | 2478 |
2475 | 2479 |
2476 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 2480 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
OLD | NEW |