| OLD | NEW |
| 1 # Dart VM Service Protocol 3.3 | 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.3_ 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, |
| (...skipping 953 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 964 | 964 |
| 965 // The library which contains this class. | 965 // The library which contains this class. |
| 966 @Library library; | 966 @Library library; |
| 967 | 967 |
| 968 // The location of this class in the source code. | 968 // The location of this class in the source code. |
| 969 SourceLocation location [optional]; | 969 SourceLocation location [optional]; |
| 970 | 970 |
| 971 // The superclass of this class, if any. | 971 // The superclass of this class, if any. |
| 972 @Class super [optional]; | 972 @Class super [optional]; |
| 973 | 973 |
| 974 // The supertype for this class, if any. |
| 975 // |
| 976 // The value will be of the kind: Type. |
| 977 @Instance superType [optional]; |
| 978 |
| 974 // A list of interface types for this class. | 979 // A list of interface types for this class. |
| 975 // | 980 // |
| 981 // The values will be of the kind: Type. |
| 982 @Instance[] interfaces; |
| 983 |
| 984 // The mixin type for this class, if any. |
| 985 // |
| 976 // The value will be of the kind: Type. | 986 // The value will be of the kind: Type. |
| 977 @Instance[] interfaces; | 987 @Instance mixin [optional]; |
| 978 | 988 |
| 979 // A list of fields in this class. Does not include fields from | 989 // A list of fields in this class. Does not include fields from |
| 980 // superclasses. | 990 // superclasses. |
| 981 @Field[] fields; | 991 @Field[] fields; |
| 982 | 992 |
| 983 // A list of functions in this class. Does not include functions | 993 // A list of functions in this class. Does not include functions |
| 984 // from superclasses. | 994 // from superclasses. |
| 985 @Function[] functions; | 995 @Function[] functions; |
| 986 | 996 |
| 987 // A list of subclasses of this class. | 997 // A list of subclasses of this class. |
| (...skipping 1513 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 2501 ## Revision History | 2511 ## Revision History |
| 2502 | 2512 |
| 2503 version | comments | 2513 version | comments |
| 2504 ------- | -------- | 2514 ------- | -------- |
| 2505 1.0 | initial revision | 2515 1.0 | initial revision |
| 2506 2.0 | Describe protocol version 2.0. | 2516 2.0 | Describe protocol version 2.0. |
| 2507 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. | 2517 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. |
| 2508 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. | 2518 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. |
| 2509 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. | 2519 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. |
| 2510 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. | 2520 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. |
| 2511 | 2521 3.4 | Add the superType and mixin fields to Class. |
| 2512 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 2522 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
| OLD | NEW |