Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(86)

Side by Side Diff: runtime/vm/service/service.md

Issue 2624493003: Document the frameIndex parameter in the service protocol specification (Closed)
Patch Set: Created 3 years, 11 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « no previous file | no next file » | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
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
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
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
OLDNEW
« no previous file with comments | « no previous file | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698