| OLD | NEW |
| 1 # Dart VM Service Protocol 3.2 | 1 # Dart VM Service Protocol 3.3 |
| 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.2_ of the Dart VM Service Protocol. This | 5 This document describes of _version 3.3_ 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, |
| 11 but this does not allow access to VM _events_ and is not documented | 11 but this does not allow access to VM _events_ and is not documented |
| 12 here. | 12 here. |
| 13 | 13 |
| 14 The Service Protocol uses [JSON-RPC 2.0][]. | 14 The Service Protocol uses [JSON-RPC 2.0][]. |
| 15 | 15 |
| (...skipping 1901 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 1917 | 1917 |
| 1918 // A list of all breakpoints for this isolate. | 1918 // A list of all breakpoints for this isolate. |
| 1919 Breakpoint[] breakpoints; | 1919 Breakpoint[] breakpoints; |
| 1920 | 1920 |
| 1921 // The error that is causing this isolate to exit, if applicable. | 1921 // The error that is causing this isolate to exit, if applicable. |
| 1922 Error error [optional]; | 1922 Error error [optional]; |
| 1923 | 1923 |
| 1924 // The current pause on exception mode for this isolate. | 1924 // The current pause on exception mode for this isolate. |
| 1925 ExceptionPauseMode exceptionPauseMode; | 1925 ExceptionPauseMode exceptionPauseMode; |
| 1926 | 1926 |
| 1927 // The list of service extension RPCs that are registered for this isolate. | 1927 // The list of service extension RPCs that are registered for this isolate, |
| 1928 string[] extensionRPCs; | 1928 // if any. |
| 1929 string[] extensionRPCs [optional]; |
| 1929 } | 1930 } |
| 1930 ``` | 1931 ``` |
| 1931 | 1932 |
| 1932 An _Isolate_ object provides information about one isolate in the VM. | 1933 An _Isolate_ object provides information about one isolate in the VM. |
| 1933 | 1934 |
| 1934 ### Library | 1935 ### Library |
| 1935 | 1936 |
| 1936 ``` | 1937 ``` |
| 1937 class @Library extends @Object { | 1938 class @Library extends @Object { |
| 1938 // The name of this library. | 1939 // The name of this library. |
| (...skipping 544 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 2483 version | comments | 2484 version | comments |
| 2484 ------- | -------- | 2485 ------- | -------- |
| 2485 1.0 | initial revision | 2486 1.0 | initial revision |
| 2486 2.0 | Describe protocol version 2.0. | 2487 2.0 | Describe protocol version 2.0. |
| 2487 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. | 2488 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. |
| 2488 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. | 2489 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. |
| 2489 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. | 2490 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. |
| 2490 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. | 2491 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. |
| 2491 | 2492 |
| 2492 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 2493 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
| OLD | NEW |