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

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

Issue 2999103002: Specify sentinels in the return type for evaluateInFrame. (Closed)
Patch Set: Created 3 years, 4 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 | « runtime/vm/service/service.md ('k') | 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 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 486 matching lines...) Expand 10 before | Expand all | Expand 10 after
497 497
498 If an error occurs while evaluating the expression, an [@Error](#error) 498 If an error occurs while evaluating the expression, an [@Error](#error)
499 reference will be returned. 499 reference will be returned.
500 500
501 If the expression is evaluated successfully, an [@Instance](#instance) 501 If the expression is evaluated successfully, an [@Instance](#instance)
502 reference will be returned. 502 reference will be returned.
503 503
504 ### evaluateInFrame 504 ### evaluateInFrame
505 505
506 ``` 506 ```
507 @Instance|@Error evaluateInFrame(string isolateId, 507 @Instance|@Error|Sentinel evaluateInFrame(string isolateId,
508 int frameIndex, 508 int frameIndex,
509 string expression, 509 string expression,
510 map<string,string> scope [optional]) 510 map<string,string> scope [optional])
511 ``` 511 ```
512 512
513 The _evaluateInFrame_ RPC is used to evaluate an expression in the 513 The _evaluateInFrame_ RPC is used to evaluate an expression in the
514 context of a particular stack frame. _frameIndex_ is the index of the 514 context of a particular stack frame. _frameIndex_ is the index of the
515 desired [Frame](#frame), with an index of _0_ indicating the top (most 515 desired [Frame](#frame), with an index of _0_ indicating the top (most
516 recent) frame. 516 recent) frame.
517 517
518 If _scope_ is provided, it should be a map from identifiers to object ids. 518 If _scope_ is provided, it should be a map from identifiers to object ids.
519 These bindings will be added to the scope in which the expression is evaluated, 519 These bindings will be added to the scope in which the expression is evaluated,
520 which is a child scope of the frame's current scope. This means bindings 520 which is a child scope of the frame's current scope. This means bindings
(...skipping 2104 matching lines...) Expand 10 before | Expand all | Expand 10 after
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
OLDNEW
« no previous file with comments | « runtime/vm/service/service.md ('k') | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698