| 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 460 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 471 ``` | 471 ``` |
| 472 | 472 |
| 473 The _getFlagList RPC returns a list of all command line flags in the | 473 The _getFlagList RPC returns a list of all command line flags in the |
| 474 VM along with their current values. | 474 VM along with their current values. |
| 475 | 475 |
| 476 See [FlagList](#flaglist). | 476 See [FlagList](#flaglist). |
| 477 | 477 |
| 478 ### getIsolate | 478 ### getIsolate |
| 479 | 479 |
| 480 ``` | 480 ``` |
| 481 Isolate getIsolate(string isolateId) | 481 Isolate|Sentinel getIsolate(string isolateId) |
| 482 ``` | 482 ``` |
| 483 | 483 |
| 484 The _getIsolate_ RPC is used to lookup an _Isolate_ object by its _id_. | 484 The _getIsolate_ RPC is used to lookup an _Isolate_ object by its _id_. |
| 485 | 485 |
| 486 If _isolateId_ refers to an isolate which has exited, then the |
| 487 _Collected_ [Sentinel](#sentinel) is returned. |
| 488 |
| 486 See [Isolate](#isolate). | 489 See [Isolate](#isolate). |
| 487 | 490 |
| 488 ### getObject | 491 ### getObject |
| 489 | 492 |
| 490 ``` | 493 ``` |
| 491 Object|Sentinel getObject(string isolateId, | 494 Object|Sentinel getObject(string isolateId, |
| 492 string objectId) | 495 string objectId) |
| 493 ``` | 496 ``` |
| 494 | 497 |
| 495 The _getObject_ RPC is used to lookup an _object_ from some isolate by | 498 The _getObject_ RPC is used to lookup an _object_ from some isolate by |
| 496 its _id_. | 499 its _id_. |
| 497 | 500 |
| 498 If _objectId_ is a temporary id which has expired, then then _Expired_ | 501 If _objectId_ is a temporary id which has expired, then then _Expired_ |
| 499 [Sentinel](#sentinel) is returned. | 502 [Sentinel](#sentinel) is returned. |
| 500 | 503 |
| 501 If _objectId_ refers to a heap object which has been collected by the VM's | 504 If _objectId_ refers to a heap object which has been collected by the VM's |
| 502 garbage collector, then the _Collected_ [Sentinel](#sentinel) is | 505 garbage collector, then the _Collected_ [Sentinel](#sentinel) is |
| (...skipping 1603 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 2106 @Isolate[] isolates; | 2109 @Isolate[] isolates; |
| 2107 } | 2110 } |
| 2108 ``` | 2111 ``` |
| 2109 | 2112 |
| 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. Added Sen
tinel return to getIsolate. |
| 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 |