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 454 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
465 | 465 |
466 See [Breakpoint](#breakpoint). | 466 See [Breakpoint](#breakpoint). |
467 | 467 |
468 Note that breakpoints are added and removed on a per-isolate basis. | 468 Note that breakpoints are added and removed on a per-isolate basis. |
469 | 469 |
470 ### evaluate | 470 ### evaluate |
471 | 471 |
472 ``` | 472 ``` |
473 @Instance|@Error|Sentinel evaluate(string isolateId, | 473 @Instance|@Error|Sentinel evaluate(string isolateId, |
474 string targetId, | 474 string targetId, |
475 string expression | 475 string expression, |
476 map<string,string> scope [optional]) | 476 map<string,string> scope [optional]) |
477 ``` | 477 ``` |
478 | 478 |
479 The _evaluate_ RPC is used to evaluate an expression in the context of | 479 The _evaluate_ RPC is used to evaluate an expression in the context of |
480 some target. | 480 some target. |
481 | 481 |
482 _targetId_ may refer to a [Library](#library), [Class](#class), or | 482 _targetId_ may refer to a [Library](#library), [Class](#class), or |
483 [Instance](#instance). | 483 [Instance](#instance). |
484 | 484 |
485 If _targetId_ is a temporary id which has expired, then the _Expired_ | 485 If _targetId_ is a temporary id which has expired, then the _Expired_ |
(...skipping 2139 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
2625 2.0 | Describe protocol version 2.0. | 2625 2.0 | Describe protocol version 2.0. |
2626 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. | 2626 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. |
2627 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. | 2627 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. |
2628 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. | 2628 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. |
2629 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. | 2629 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. |
2630 3.4 | Add the superType and mixin fields to Class. Added new pause event 'None'. | 2630 3.4 | Add the superType and mixin fields to Class. Added new pause event 'None'. |
2631 3.5 | Add the error field to SourceReportRange. Clarify definition of token pos
ition. Add "Isolate must be paused" error code. | 2631 3.5 | Add the error field to SourceReportRange. Clarify definition of token pos
ition. Add "Isolate must be paused" error code. |
2632 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. Add optional parameter 'scope' to 'evaluate' and 'evaluate
InFrame'. | 2632 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. Add optional parameter 'scope' to 'evaluate' and 'evaluate
InFrame'. |
2633 | 2633 |
2634 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 2634 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
OLD | NEW |