OLD | NEW |
1 Note: this dev version of the protocol contains not yet released functionality, | 1 Note: this dev version of the protocol contains not yet released functionality, |
2 and is subject to change. | 2 and is subject to change. |
3 | 3 |
4 # Dart VM Service Protocol 3.6-dev | 4 # Dart VM Service Protocol 3.6-dev |
5 | 5 |
6 > Please post feedback to the [observatory-discuss group][discuss-list] | 6 > Please post feedback to the [observatory-discuss group][discuss-list] |
7 | 7 |
8 This document describes of _version 3.5_ of the Dart VM Service Protocol. This | 8 This document describes of _version 3.5_ of the Dart VM Service Protocol. This |
9 protocol is used to communicate with a running Dart Virtual Machine. | 9 protocol is used to communicate with a running Dart Virtual Machine. |
10 | 10 |
(...skipping 2241 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
2252 Adding new values to _SentinelKind_ is considered a backwards | 2252 Adding new values to _SentinelKind_ is considered a backwards |
2253 compatible change. Clients must handle this gracefully. | 2253 compatible change. Clients must handle this gracefully. |
2254 | 2254 |
2255 | 2255 |
2256 ### FrameKind | 2256 ### FrameKind |
2257 ``` | 2257 ``` |
2258 enum FrameKind { | 2258 enum FrameKind { |
2259 Regular, | 2259 Regular, |
2260 AsyncCausal, | 2260 AsyncCausal, |
2261 AsyncSuspensionMarker, | 2261 AsyncSuspensionMarker, |
| 2262 AsyncActivation |
2262 } | 2263 } |
2263 ``` | 2264 ``` |
2264 | 2265 |
2265 A _FrameKind_ is used to distinguish different kinds of _Frame_ objects. | 2266 A _FrameKind_ is used to distinguish different kinds of _Frame_ objects. |
2266 | 2267 |
2267 ### Script | 2268 ### Script |
2268 | 2269 |
2269 ``` | 2270 ``` |
2270 class @Script extends @Object { | 2271 class @Script extends @Object { |
2271 // The uri from which this script was loaded. | 2272 // The uri from which this script was loaded. |
(...skipping 337 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
2609 2.0 | Describe protocol version 2.0. | 2610 2.0 | Describe protocol version 2.0. |
2610 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. | 2611 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. |
2611 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. | 2612 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. |
2612 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. | 2613 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. |
2613 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. | 2614 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. |
2614 3.4 | Add the superType and mixin fields to Class. Added new pause event 'None'. | 2615 3.4 | Add the superType and mixin fields to Class. Added new pause event 'None'. |
2615 3.5 | Add the error field to SourceReportRange. Clarify definition of token pos
ition. Add "Isolate must be paused" error code. | 2616 3.5 | Add the error field to SourceReportRange. Clarify definition of token pos
ition. Add "Isolate must be paused" error code. |
2616 3.6 (unreleased) | Add 'scopeStartTokenPos', 'scopeEndTokenPos', and 'declaratio
nTokenPos' to BoundVariable. Add 'PausePostRequest' event kind. Add 'Rewind' Ste
pOption. Add error code 107 (isolate cannot resume). Add 'reloadSources' RPC and
related error codes. | 2617 3.6 (unreleased) | Add 'scopeStartTokenPos', 'scopeEndTokenPos', and 'declaratio
nTokenPos' to BoundVariable. Add 'PausePostRequest' event kind. Add 'Rewind' Ste
pOption. Add error code 107 (isolate cannot resume). Add 'reloadSources' RPC and
related error codes. |
2617 | 2618 |
2618 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 2619 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
OLD | NEW |