| 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 476 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 487 | 487 |
| 488 If an error occurs while evaluating the expression, an [@Error](#error) | 488 If an error occurs while evaluating the expression, an [@Error](#error) |
| 489 reference will be returned. | 489 reference will be returned. |
| 490 | 490 |
| 491 If the expression is evaluated successfully, an [@Instance](#instance) | 491 If the expression is evaluated successfully, an [@Instance](#instance) |
| 492 reference will be returned. | 492 reference will be returned. |
| 493 | 493 |
| 494 ### evaluateInFrame | 494 ### evaluateInFrame |
| 495 | 495 |
| 496 ``` | 496 ``` |
| 497 @Instance|@Error evaluateInFrame(string isolateId, | 497 @Instance|@Error|Sentinel evaluateInFrame(string isolateId, |
| 498 int frameIndex, | 498 int frameIndex, |
| 499 string expression) | 499 string expression) |
| 500 ``` | 500 ``` |
| 501 | 501 |
| 502 The _evaluateInFrame_ RPC is used to evaluate an expression in the | 502 The _evaluateInFrame_ RPC is used to evaluate an expression in the |
| 503 context of a particular stack frame. _frameIndex_ is the index of the | 503 context of a particular stack frame. _frameIndex_ is the index of the |
| 504 desired [Frame](#frame), with an index of _0_ indicating the top (most | 504 desired [Frame](#frame), with an index of _0_ indicating the top (most |
| 505 recent) frame. | 505 recent) frame. |
| 506 | 506 |
| 507 If an error occurs while evaluating the expression, an [@Error](#error) | 507 If an error occurs while evaluating the expression, an [@Error](#error) |
| 508 reference will be returned. | 508 reference will be returned. |
| 509 | 509 |
| (...skipping 2082 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 2592 2.0 | Describe protocol version 2.0. | 2592 2.0 | Describe protocol version 2.0. |
| 2593 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. | 2593 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. |
| 2594 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. | 2594 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. |
| 2595 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. | 2595 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. |
| 2596 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. | 2596 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. |
| 2597 3.4 | Add the superType and mixin fields to Class. Added new pause event 'None'. | 2597 3.4 | Add the superType and mixin fields to Class. Added new pause event 'None'. |
| 2598 3.5 | Add the error field to SourceReportRange. Clarify definition of token pos
ition. Add "Isolate must be paused" error code. | 2598 3.5 | Add the error field to SourceReportRange. Clarify definition of token pos
ition. Add "Isolate must be paused" error code. |
| 2599 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. | 2599 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. |
| 2600 | 2600 |
| 2601 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 2601 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
| OLD | NEW |