| 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 679 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 690 The _removeBreakpoint_ RPC is used to remove a breakpoint by its _id_. | 690 The _removeBreakpoint_ RPC is used to remove a breakpoint by its _id_. |
| 691 | 691 |
| 692 Note that breakpoints are added and removed on a per-isolate basis. | 692 Note that breakpoints are added and removed on a per-isolate basis. |
| 693 | 693 |
| 694 See [Success](#success). | 694 See [Success](#success). |
| 695 | 695 |
| 696 ### resume | 696 ### resume |
| 697 | 697 |
| 698 ``` | 698 ``` |
| 699 Success resume(string isolateId, | 699 Success resume(string isolateId, |
| 700 StepOption step [optional]) | 700 StepOption step [optional], |
| 701 int frameIndex [optional]) |
| 701 ``` | 702 ``` |
| 702 | 703 |
| 703 The _resume_ RPC is used to resume execution of a paused isolate. | 704 The _resume_ RPC is used to resume execution of a paused isolate. |
| 704 | 705 |
| 705 If the _step_ parameter is not provided, the program will resume | 706 If the _step_ parameter is not provided, the program will resume |
| 706 regular execution. | 707 regular execution. |
| 707 | 708 |
| 708 If the _step_ parameter is provided, it indicates what form of | 709 If the _step_ parameter is provided, it indicates what form of |
| 709 single-stepping to use. | 710 single-stepping to use. |
| 710 | 711 |
| 711 step | meaning | 712 step | meaning |
| 712 ---- | ------- | 713 ---- | ------- |
| 713 Into | Single step, entering function calls | 714 Into | Single step, entering function calls |
| 714 Over | Single step, skipping over function calls | 715 Over | Single step, skipping over function calls |
| 715 Out | Single step until the current function exits | 716 Out | Single step until the current function exits |
| 716 Rewind | Immediately exit the top frame(s) without executing any code. Isolate w
ill be paused at the call of the last exited function. | 717 Rewind | Immediately exit the top frame(s) without executing any code. Isolate w
ill be paused at the call of the last exited function. |
| 717 | 718 |
| 719 The _frameIndex_ parameter is only used when the _step_ parameter is Rewind. It |
| 720 specifies the stack frame to rewind to. Stack frame 0 is the currently executing |
| 721 function, so _frameIndex_ must be at least 1. |
| 722 |
| 723 If the _frameIndex_ parameter is not provided, it defaults to 1. |
| 724 |
| 718 See [Success](#success), [StepOption](#StepOption). | 725 See [Success](#success), [StepOption](#StepOption). |
| 719 | 726 |
| 720 ### setExceptionPauseMode | 727 ### setExceptionPauseMode |
| 721 | 728 |
| 722 ``` | 729 ``` |
| 723 Success setExceptionPauseMode(string isolateId, | 730 Success setExceptionPauseMode(string isolateId, |
| 724 ExceptionPauseMode mode) | 731 ExceptionPauseMode mode) |
| 725 ``` | 732 ``` |
| 726 | 733 |
| 727 The _setExceptionPauseMode_ RPC is used to control if an isolate pauses when | 734 The _setExceptionPauseMode_ RPC is used to control if an isolate pauses when |
| (...skipping 1857 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 2585 2.0 | Describe protocol version 2.0. | 2592 2.0 | Describe protocol version 2.0. |
| 2586 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. |
| 2587 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. |
| 2588 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. |
| 2589 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. |
| 2590 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'. |
| 2591 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. |
| 2592 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. |
| 2593 | 2600 |
| 2594 [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 |