| 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 2198 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 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 Loading... |
| 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 |
| OLD | NEW |