| OLD | NEW |
| 1 # Dart VM Service Protocol 3.5 | 1 # Dart VM Service Protocol 3.5 |
| 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.5_ of the Dart VM Service Protocol. This | 5 This document describes of _version 3.5_ 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 877 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 888 | 888 |
| 889 If the field is being initialized, the _value_ will be the | 889 If the field is being initialized, the _value_ will be the |
| 890 _BeingInitialized_ [Sentinel](#sentinel). | 890 _BeingInitialized_ [Sentinel](#sentinel). |
| 891 | 891 |
| 892 ### BoundVariable | 892 ### BoundVariable |
| 893 | 893 |
| 894 ``` | 894 ``` |
| 895 class BoundVariable { | 895 class BoundVariable { |
| 896 string name; | 896 string name; |
| 897 @Instance|Sentinel value; | 897 @Instance|Sentinel value; |
| 898 |
| 899 // The token position where this variable was declared. |
| 900 int declarationTokenPos; |
| 901 |
| 902 // The first token position where this variable is visible to the scope. |
| 903 int scopeStartTokenPos; |
| 904 |
| 905 // The last token position where this variable is visible to the scope. |
| 906 int scopeEndTokenPos; |
| 898 } | 907 } |
| 899 ``` | 908 ``` |
| 900 | 909 |
| 901 A _BoundVariable_ represents a local variable bound to a particular value | 910 A _BoundVariable_ represents a local variable bound to a particular value |
| 902 in a _Frame_. | 911 in a _Frame_. |
| 903 | 912 |
| 904 If the variable is uninitialized, the _value_ will be the | 913 If the variable is uninitialized, the _value_ will be the |
| 905 _NotInitialized_ [Sentinel](#sentinel). | 914 _NotInitialized_ [Sentinel](#sentinel). |
| 906 | 915 |
| 907 If the variable is being initialized, the _value_ will be the | 916 If the variable is being initialized, the _value_ will be the |
| (...skipping 1613 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 2521 version | comments | 2530 version | comments |
| 2522 ------- | -------- | 2531 ------- | -------- |
| 2523 1.0 | initial revision | 2532 1.0 | initial revision |
| 2524 2.0 | Describe protocol version 2.0. | 2533 2.0 | Describe protocol version 2.0. |
| 2525 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. | 2534 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. |
| 2526 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. | 2535 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. |
| 2527 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. | 2536 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. |
| 2528 3.3 | Pause event now indicates if the isolate is paused at an await, yield, or
yield* suspension point via the 'atAsyncSuspension' field. Resume command now su
pports the step parameter 'OverAsyncSuspension'. A Breakpoint added syntheticall
y by an 'OverAsyncSuspension' resume command identifies itself as such via the '
isSyntheticAsyncContinuation' field. | 2537 3.3 | Pause event now indicates if the isolate is paused at an await, yield, or
yield* suspension point via the 'atAsyncSuspension' field. Resume command now su
pports the step parameter 'OverAsyncSuspension'. A Breakpoint added syntheticall
y by an 'OverAsyncSuspension' resume command identifies itself as such via the '
isSyntheticAsyncContinuation' field. |
| 2529 3.4 | Add the superType and mixin fields to Class. Added new pause event 'None'. | 2538 3.4 | Add the superType and mixin fields to Class. Added new pause event 'None'. |
| 2530 3.5 | Add the error field to SourceReportRange. Clarify definition of token pos
ition. Add "Isolate must be paused" error code. | 2539 3.5 | Add the error field to SourceReportRange. Clarify definition of token pos
ition. Add "Isolate must be paused" error code. |
| 2540 3.6 (unreleased) | Add 'scopeStartTokenPos', 'scopeEndTokenPos', and 'declaratio
nTokenPos' to BoundVariable. |
| 2541 |
| 2531 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 2542 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
| OLD | NEW |