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 |