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

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

Issue 1965423003: Clarify definition of token position. (Closed) Base URL: git@github.com:dart-lang/sdk.git@master
Patch Set: Created 4 years, 7 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 2198 matching lines...) Expand 10 before | Expand all | Expand 10 after
2209 } 2209 }
2210 ``` 2210 ```
2211 2211
2212 A _Script_ provides information about a Dart language script. 2212 A _Script_ provides information about a Dart language script.
2213 2213
2214 The _tokenPosTable_ is an array of int arrays. Each subarray 2214 The _tokenPosTable_ is an array of int arrays. Each subarray
2215 consists of a line number followed by _(tokenPos, columnNumber)_ pairs: 2215 consists of a line number followed by _(tokenPos, columnNumber)_ pairs:
2216 2216
2217 > [lineNumber, (tokenPos, columnNumber)*] 2217 > [lineNumber, (tokenPos, columnNumber)*]
2218 2218
2219 The _tokenPos_ is an arbitrary integer value that is used to represent
2220 a location in the source code. A _tokenPos_ value is not meaningful
2221 in itself and code should not rely on the exact values returned.
2222
2219 For example, a _tokenPosTable_ with the value... 2223 For example, a _tokenPosTable_ with the value...
2220 2224
2221 > [[1, 100, 5, 101, 8],[2, 102, 7]] 2225 > [[1, 100, 5, 101, 8],[2, 102, 7]]
2222 2226
2223 ...encodes the mapping: 2227 ...encodes the mapping:
2224 2228
2225 tokenPos | line | column 2229 tokenPos | line | column
2226 -------- | ---- | ------ 2230 -------- | ---- | ------
2227 100 | 1 | 5 2231 100 | 1 | 5
2228 101 | 1 | 8 2232 101 | 1 | 8
(...skipping 287 matching lines...) Expand 10 before | Expand all | Expand 10 after
2516 2520
2517 version | comments 2521 version | comments
2518 ------- | -------- 2522 ------- | --------
2519 1.0 | initial revision 2523 1.0 | initial revision
2520 2.0 | Describe protocol version 2.0. 2524 2.0 | Describe protocol version 2.0.
2521 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. 2525 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.
2522 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. 2526 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.
2523 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. 2527 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.
2524 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. 2528 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.
2525 3.4 | Add the superType and mixin fields to Class. Added new pause event 'None'. 2529 3.4 | Add the superType and mixin fields to Class. Added new pause event 'None'.
2526 3.5 | Add the error field to SourceReportRange. 2530 3.5 | Add the error field to SourceReportRange. Clarify definition of token pos ition.
2527 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato ry-discuss 2531 [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