OLD | NEW |
1 # Dart VM Service Protocol 1.0 (Draft 1) | 1 # Dart VM Service Protocol 1.0 (Draft 1) |
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 _draft 1_ of _version 1.0_ of the Dart VM | 5 This document describes _draft 1_ of _version 1.0_ of the Dart VM |
6 Service Protocol. This protocol is used to communicate with a running | 6 Service Protocol. This protocol is used to communicate with a running |
7 Dart Virtual Machine. | 7 Dart Virtual Machine. |
8 | 8 |
9 To use the Service Protocol, start the VM with the *--observe* flag. | 9 To use the Service Protocol, start the VM with the *--observe* flag. |
10 The VM will start a webserver which services protocol requests via WebSocket. | 10 The VM will start a webserver which services protocol requests via WebSocket. |
(...skipping 1211 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
1222 string valueAsString [optional]; | 1222 string valueAsString [optional]; |
1223 | 1223 |
1224 // The valueAsString for String references may be truncated. If so, | 1224 // The valueAsString for String references may be truncated. If so, |
1225 // this property is added with the value 'true'. | 1225 // this property is added with the value 'true'. |
1226 bool valueAsStringIsTruncated [optional]; | 1226 bool valueAsStringIsTruncated [optional]; |
1227 | 1227 |
1228 // The length of a List instance. | 1228 // The length of a List instance. |
1229 // | 1229 // |
1230 // Provided for instance kinds: | 1230 // Provided for instance kinds: |
1231 // List | 1231 // List |
| 1232 // Map |
| 1233 // TypedData |
1232 int length [optional]; | 1234 int length [optional]; |
1233 | 1235 |
1234 // The name of a Type instance. | 1236 // The name of a Type instance. |
1235 // | 1237 // |
1236 // Provided for instance kinds: | 1238 // Provided for instance kinds: |
1237 // Type | 1239 // Type |
1238 string name [optional]; | 1240 string name [optional]; |
1239 | 1241 |
1240 // The corresponding Class if this Type is canonical. | 1242 // The corresponding Class if this Type is canonical. |
1241 // | 1243 // |
(...skipping 29 matching lines...) Expand all Loading... |
1271 string valueAsString [optional]; | 1273 string valueAsString [optional]; |
1272 | 1274 |
1273 // The valueAsString for String references may be truncated. If so, | 1275 // The valueAsString for String references may be truncated. If so, |
1274 // this property is added with the value 'true'. | 1276 // this property is added with the value 'true'. |
1275 bool valueAsStringIsTruncated [optional]; | 1277 bool valueAsStringIsTruncated [optional]; |
1276 | 1278 |
1277 // The length of a List instance. | 1279 // The length of a List instance. |
1278 // | 1280 // |
1279 // Provided for instance kinds: | 1281 // Provided for instance kinds: |
1280 // List | 1282 // List |
| 1283 // Map |
| 1284 // TypedData |
1281 int length [optional]; | 1285 int length [optional]; |
1282 | 1286 |
1283 // The name of a Type instance. | 1287 // The name of a Type instance. |
1284 // | 1288 // |
1285 // Provided for instance kinds: | 1289 // Provided for instance kinds: |
1286 // Type | 1290 // Type |
1287 string name [optional]; | 1291 string name [optional]; |
1288 | 1292 |
1289 // The corresponding Class if this Type is canonical. | 1293 // The corresponding Class if this Type is canonical. |
1290 // | 1294 // |
(...skipping 15 matching lines...) Expand all Loading... |
1306 // Provided for instance kinds: | 1310 // Provided for instance kinds: |
1307 // List | 1311 // List |
1308 @Instance|Sentinel[] elements [optional]; | 1312 @Instance|Sentinel[] elements [optional]; |
1309 | 1313 |
1310 // The elements of a List instance. | 1314 // The elements of a List instance. |
1311 // | 1315 // |
1312 // Provided for instance kinds: | 1316 // Provided for instance kinds: |
1313 // Map | 1317 // Map |
1314 MapAssociation[] associations [optional]; | 1318 MapAssociation[] associations [optional]; |
1315 | 1319 |
| 1320 // The bytes of a TypedData instance. |
| 1321 // |
| 1322 // Provided for instance kinds: |
| 1323 // TypedData |
| 1324 int[] bytes [optional]; |
| 1325 |
1316 // The function associated with a Closure instance. | 1326 // The function associated with a Closure instance. |
1317 // | 1327 // |
1318 // Provided for instance kinds: | 1328 // Provided for instance kinds: |
1319 // Closure | 1329 // Closure |
1320 @Function closureFunction [optional]; | 1330 @Function closureFunction [optional]; |
1321 | 1331 |
1322 // The context associated with a Closure instance. | 1332 // The context associated with a Closure instance. |
1323 // | 1333 // |
1324 // Provided for instance kinds: | 1334 // Provided for instance kinds: |
1325 // Closure | 1335 // Closure |
(...skipping 78 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
1404 String, | 1414 String, |
1405 | 1415 |
1406 // An instance of the built-in VM List implementation. User-defined | 1416 // An instance of the built-in VM List implementation. User-defined |
1407 // Lists will be PlainInstance. | 1417 // Lists will be PlainInstance. |
1408 List, | 1418 List, |
1409 | 1419 |
1410 // An instance of the built-in VM Map implementation. User-defined | 1420 // An instance of the built-in VM Map implementation. User-defined |
1411 // Maps will be PlainInstance. | 1421 // Maps will be PlainInstance. |
1412 Map, | 1422 Map, |
1413 | 1423 |
| 1424 // An instance of the built-in VM TypedData implementations. User-defined |
| 1425 // TypedDatas will be PlainInstance. |
| 1426 TypedData, |
| 1427 |
1414 // An instance of the built-in VM Closure implementation. User-defined | 1428 // An instance of the built-in VM Closure implementation. User-defined |
1415 // Closures will be PlainInstance. | 1429 // Closures will be PlainInstance. |
1416 Closure, | 1430 Closure, |
1417 | 1431 |
1418 // An instance of the Dart class MirrorReference. | 1432 // An instance of the Dart class MirrorReference. |
1419 MirrorReference, | 1433 MirrorReference, |
1420 | 1434 |
1421 // An instance of the Dart class WeakProperty. | 1435 // An instance of the Dart class WeakProperty. |
1422 WeakProperty, | 1436 WeakProperty, |
1423 | 1437 |
(...skipping 455 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
1879 ``` | 1893 ``` |
1880 | 1894 |
1881 ## Revision History | 1895 ## Revision History |
1882 | 1896 |
1883 version | comments | 1897 version | comments |
1884 ------- | -------- | 1898 ------- | -------- |
1885 1.0 draft 1 | initial revision | 1899 1.0 draft 1 | initial revision |
1886 | 1900 |
1887 | 1901 |
1888 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 1902 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
OLD | NEW |