| OLD | NEW |
| 1 # Dart VM Service Protocol 2.0 | 1 # Dart VM Service Protocol 2.0 |
| 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 2.0_ of the Dart VM Service Protocol. This | 5 This document describes of _version 2.0_ 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 738 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 749 | 749 |
| 750 If the variable is being initialized, the _value_ will be the | 750 If the variable is being initialized, the _value_ will be the |
| 751 _BeingInitialized_ [Sentinel](#sentinel). | 751 _BeingInitialized_ [Sentinel](#sentinel). |
| 752 | 752 |
| 753 If the variable has been optimized out by the compiler, the _value_ | 753 If the variable has been optimized out by the compiler, the _value_ |
| 754 will be the _OptimizedOut_ [Sentinel](#sentinel). | 754 will be the _OptimizedOut_ [Sentinel](#sentinel). |
| 755 | 755 |
| 756 ### Breakpoint | 756 ### Breakpoint |
| 757 | 757 |
| 758 ``` | 758 ``` |
| 759 class Breakpoint extends Response { | 759 class Breakpoint extends Object { |
| 760 int breakpointNumber; | 760 int breakpointNumber; |
| 761 bool resolved; | 761 bool resolved; |
| 762 SourceLocation location; | 762 SourceLocation location; |
| 763 } | 763 } |
| 764 ``` | 764 ``` |
| 765 | 765 |
| 766 A _Breakpoint_ describes a debugger breakpoint. | 766 A _Breakpoint_ describes a debugger breakpoint. |
| 767 | 767 |
| 768 ### Class | 768 ### Class |
| 769 | 769 |
| 770 ``` | 770 ``` |
| 771 class @Class extends @Object { | 771 class @Class extends @Object { |
| 772 // The name of this class. | 772 // The name of this class. |
| 773 string name; | 773 string name; |
| 774 } | 774 } |
| 775 ``` | 775 ``` |
| 776 | 776 |
| 777 _@Class_ is a reference to a _Class_. | 777 _@Class_ is a reference to a _Class_. |
| 778 | 778 |
| 779 ``` | 779 ``` |
| 780 class Class extends Object { | 780 class Class extends Object { |
| 781 // The name of this class. | 781 // The name of this class. |
| 782 string name; | 782 string name; |
| 783 | 783 |
| 784 // The error which occurred during class finalization, if it exists. | 784 // The error which occurred during class finalization, if it exists. |
| 785 @Instance error [optional]; | 785 @Error error [optional]; |
| 786 | 786 |
| 787 // Is this an abstract class? | 787 // Is this an abstract class? |
| 788 bool abstract; | 788 bool abstract; |
| 789 | 789 |
| 790 // Is this a const class? | 790 // Is this a const class? |
| 791 bool const; | 791 bool const; |
| 792 | 792 |
| 793 // Has this class been finalized? | 793 // Has this class been finalized? |
| 794 bool finalized; | 794 bool finalized; |
| 795 | 795 |
| (...skipping 361 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 1157 string valueAsString [optional]; | 1157 string valueAsString [optional]; |
| 1158 } | 1158 } |
| 1159 ``` | 1159 ``` |
| 1160 | 1160 |
| 1161 A _Flag_ represents a single VM command line flag. | 1161 A _Flag_ represents a single VM command line flag. |
| 1162 | 1162 |
| 1163 ### FlagList | 1163 ### FlagList |
| 1164 | 1164 |
| 1165 ``` | 1165 ``` |
| 1166 class FlagList extends Response { | 1166 class FlagList extends Response { |
| 1167 // A list of all flags which are set to default values. | 1167 // A list of all flags in the VM. |
| 1168 Flag[] unmodifiedFlags; | 1168 Flag[] flags; |
| 1169 | |
| 1170 // A list of all flags which have been modified by the user. | |
| 1171 Flag[] modifiedFlags; | |
| 1172 } | 1169 } |
| 1173 ``` | 1170 ``` |
| 1174 | 1171 |
| 1175 A _FlagList_ represents the complete set of VM command line flags. | 1172 A _FlagList_ represents the complete set of VM command line flags. |
| 1176 | 1173 |
| 1177 ### Frame | 1174 ### Frame |
| 1178 | 1175 |
| 1179 ``` | 1176 ``` |
| 1180 class Frame extends Response { | 1177 class Frame extends Response { |
| 1181 int index; | 1178 int index; |
| 1182 @Function function; | 1179 @Function function; |
| 1183 @Code code; | 1180 @Code code; |
| 1184 @Script script; | 1181 SourceLocation location; |
| 1185 int tokenPos; | |
| 1186 BoundVariable[] vars; | 1182 BoundVariable[] vars; |
| 1187 } | 1183 } |
| 1188 ``` | 1184 ``` |
| 1189 | 1185 |
| 1190 ### Function | 1186 ### Function |
| 1191 | 1187 |
| 1192 ``` | 1188 ``` |
| 1193 class @Function extends @Object { | 1189 class @Function extends @Object { |
| 1194 // The name of this function. | 1190 // The name of this function. |
| 1195 string name; | 1191 string name; |
| (...skipping 807 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 2003 ``` | 1999 ``` |
| 2004 | 2000 |
| 2005 ## Revision History | 2001 ## Revision History |
| 2006 | 2002 |
| 2007 version | comments | 2003 version | comments |
| 2008 ------- | -------- | 2004 ------- | -------- |
| 2009 1.0 draft 1 | initial revision | 2005 1.0 draft 1 | initial revision |
| 2010 | 2006 |
| 2011 | 2007 |
| 2012 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 2008 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
| OLD | NEW |