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

Side by Side Diff: runtime/vm/service/service.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 | « no previous file | runtime/vm/service/service_dev.md » ('j') | 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 476 matching lines...) Expand 10 before | Expand all | Expand 10 after
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
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
OLDNEW
« no previous file with comments | « no previous file | runtime/vm/service/service_dev.md » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698