Chromium Code Reviews| 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 750 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 761 ``` | 761 ``` |
| 762 PropertyType optionalProperty [optional]; | 762 PropertyType optionalProperty [optional]; |
| 763 ``` | 763 ``` |
| 764 | 764 |
| 765 If a property can have multiple independent types, we denote this with | 765 If a property can have multiple independent types, we denote this with |
| 766 a vertical bar: | 766 a vertical bar: |
| 767 | 767 |
| 768 ``` | 768 ``` |
| 769 PropertyType1|PropertyType2 complexProperty; | 769 PropertyType1|PropertyType2 complexProperty; |
| 770 ``` | 770 ``` |
| 771 | 771 |
|
turnidge
2015/10/12 16:51:19
Document parens here. Something like:
We also al
Cutch
2015/10/12 17:40:47
Done.
| |
| 772 When a string is only permitted to take one of a certain set of values, | 772 When a string is only permitted to take one of a certain set of values, |
| 773 we indicate this by the use of the _enum_ format: | 773 we indicate this by the use of the _enum_ format: |
| 774 | 774 |
| 775 ``` | 775 ``` |
| 776 enum PermittedValues { | 776 enum PermittedValues { |
| 777 Value1, | 777 Value1, |
| 778 Value2 | 778 Value2 |
| 779 } | 779 } |
| 780 ``` | 780 ``` |
| 781 | 781 |
| (...skipping 675 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 1457 // TypeParameter | 1457 // TypeParameter |
| 1458 @Class parameterizedClass [optional]; | 1458 @Class parameterizedClass [optional]; |
| 1459 | 1459 |
| 1460 // The fields of this Instance. | 1460 // The fields of this Instance. |
| 1461 BoundField[] fields [optional]; | 1461 BoundField[] fields [optional]; |
| 1462 | 1462 |
| 1463 // The elements of a List instance. | 1463 // The elements of a List instance. |
| 1464 // | 1464 // |
| 1465 // Provided for instance kinds: | 1465 // Provided for instance kinds: |
| 1466 // List | 1466 // List |
| 1467 @Instance|Sentinel[] elements [optional]; | 1467 @Instance[]|Sentinel[] elements [optional]; |
|
turnidge
2015/10/12 16:51:19
This would mean that we either return a vector of
Cutch
2015/10/12 17:40:47
Done.
| |
| 1468 | 1468 |
| 1469 // The elements of a List instance. | 1469 // The elements of a List instance. |
| 1470 // | 1470 // |
| 1471 // Provided for instance kinds: | 1471 // Provided for instance kinds: |
| 1472 // Map | 1472 // Map |
| 1473 MapAssociation[] associations [optional]; | 1473 MapAssociation[] associations [optional]; |
| 1474 | 1474 |
| 1475 // The bytes of a TypedData instance. | 1475 // The bytes of a TypedData instance. |
| 1476 // | 1476 // |
| 1477 // The data is provided as a Base64 encoded string. | 1477 // The data is provided as a Base64 encoded string. |
| (...skipping 651 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 2129 // in a backwards compatible way. | 2129 // in a backwards compatible way. |
| 2130 int minor; | 2130 int minor; |
| 2131 } | 2131 } |
| 2132 ``` | 2132 ``` |
| 2133 | 2133 |
| 2134 See [Versioning](#versioning). | 2134 See [Versioning](#versioning). |
| 2135 | 2135 |
| 2136 ### VM | 2136 ### VM |
| 2137 | 2137 |
| 2138 ``` | 2138 ``` |
| 2139 class @VM extends Response { | |
| 2140 // A name identifying this vm. Not guaranteed to be unique. | |
| 2141 string name; | |
| 2142 } | |
| 2143 ``` | |
| 2144 | |
| 2145 _@VM_ is a reference to a _VM_ object. | |
| 2146 | |
| 2147 ``` | |
| 2139 class VM extends Response { | 2148 class VM extends Response { |
| 2140 // Word length on target architecture (e.g. 32, 64). | 2149 // Word length on target architecture (e.g. 32, 64). |
| 2141 int architectureBits; | 2150 int architectureBits; |
| 2142 | 2151 |
| 2143 // The CPU we are generating code for. | 2152 // The CPU we are generating code for. |
| 2144 string targetCPU; | 2153 string targetCPU; |
| 2145 | 2154 |
| 2146 // The CPU we are actually running on. | 2155 // The CPU we are actually running on. |
| 2147 string hostCPU; | 2156 string hostCPU; |
| 2148 | 2157 |
| (...skipping 16 matching lines...) Expand all Loading... | |
| 2165 ## Revision History | 2174 ## Revision History |
| 2166 | 2175 |
| 2167 version | comments | 2176 version | comments |
| 2168 ------- | -------- | 2177 ------- | -------- |
| 2169 1.0 | initial revision | 2178 1.0 | initial revision |
| 2170 2.0 | Describe protocol version 2.0. | 2179 2.0 | Describe protocol version 2.0. |
| 2171 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 . | 2180 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 . |
| 2172 | 2181 |
| 2173 | 2182 |
| 2174 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato ry-discuss | 2183 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato ry-discuss |
| OLD | NEW |