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 // Uint8ClampedList |
| 1234 // Uint8List |
| 1235 // Uint16List |
| 1236 // Uint32List |
| 1237 // Uint64List |
| 1238 // Int8List |
| 1239 // Int16List |
| 1240 // Int32List |
| 1241 // Int64List |
| 1242 // Float32List |
| 1243 // Float64List |
| 1244 // Int32x4List |
| 1245 // Float32x4List |
| 1246 // Float64x2List |
1232 int length [optional]; | 1247 int length [optional]; |
1233 | 1248 |
1234 // The name of a Type instance. | 1249 // The name of a Type instance. |
1235 // | 1250 // |
1236 // Provided for instance kinds: | 1251 // Provided for instance kinds: |
1237 // Type | 1252 // Type |
1238 string name [optional]; | 1253 string name [optional]; |
1239 | 1254 |
1240 // The corresponding Class if this Type is canonical. | 1255 // The corresponding Class if this Type is canonical. |
1241 // | 1256 // |
(...skipping 29 matching lines...) Expand all Loading... |
1271 string valueAsString [optional]; | 1286 string valueAsString [optional]; |
1272 | 1287 |
1273 // The valueAsString for String references may be truncated. If so, | 1288 // The valueAsString for String references may be truncated. If so, |
1274 // this property is added with the value 'true'. | 1289 // this property is added with the value 'true'. |
1275 bool valueAsStringIsTruncated [optional]; | 1290 bool valueAsStringIsTruncated [optional]; |
1276 | 1291 |
1277 // The length of a List instance. | 1292 // The length of a List instance. |
1278 // | 1293 // |
1279 // Provided for instance kinds: | 1294 // Provided for instance kinds: |
1280 // List | 1295 // List |
| 1296 // Map |
| 1297 // Uint8ClampedList |
| 1298 // Uint8List |
| 1299 // Uint16List |
| 1300 // Uint32List |
| 1301 // Uint64List |
| 1302 // Int8List |
| 1303 // Int16List |
| 1304 // Int32List |
| 1305 // Int64List |
| 1306 // Float32List |
| 1307 // Float64List |
| 1308 // Int32x4List |
| 1309 // Float32x4List |
| 1310 // Float64x2List |
1281 int length [optional]; | 1311 int length [optional]; |
1282 | 1312 |
1283 // The name of a Type instance. | 1313 // The name of a Type instance. |
1284 // | 1314 // |
1285 // Provided for instance kinds: | 1315 // Provided for instance kinds: |
1286 // Type | 1316 // Type |
1287 string name [optional]; | 1317 string name [optional]; |
1288 | 1318 |
1289 // The corresponding Class if this Type is canonical. | 1319 // The corresponding Class if this Type is canonical. |
1290 // | 1320 // |
(...skipping 15 matching lines...) Expand all Loading... |
1306 // Provided for instance kinds: | 1336 // Provided for instance kinds: |
1307 // List | 1337 // List |
1308 @Instance|Sentinel[] elements [optional]; | 1338 @Instance|Sentinel[] elements [optional]; |
1309 | 1339 |
1310 // The elements of a List instance. | 1340 // The elements of a List instance. |
1311 // | 1341 // |
1312 // Provided for instance kinds: | 1342 // Provided for instance kinds: |
1313 // Map | 1343 // Map |
1314 MapAssociation[] associations [optional]; | 1344 MapAssociation[] associations [optional]; |
1315 | 1345 |
| 1346 // The bytes of a TypedData instance. |
| 1347 // |
| 1348 // Provided for instance kinds: |
| 1349 // Uint8ClampedList |
| 1350 // Uint8List |
| 1351 // Uint16List |
| 1352 // Uint32List |
| 1353 // Uint64List |
| 1354 // Int8List |
| 1355 // Int16List |
| 1356 // Int32List |
| 1357 // Int64List |
| 1358 // Float32List |
| 1359 // Float64List |
| 1360 // Int32x4List |
| 1361 // Float32x4List |
| 1362 // Float64x2List |
| 1363 int[] bytes [optional]; |
| 1364 |
1316 // The function associated with a Closure instance. | 1365 // The function associated with a Closure instance. |
1317 // | 1366 // |
1318 // Provided for instance kinds: | 1367 // Provided for instance kinds: |
1319 // Closure | 1368 // Closure |
1320 @Function closureFunction [optional]; | 1369 @Function closureFunction [optional]; |
1321 | 1370 |
1322 // The context associated with a Closure instance. | 1371 // The context associated with a Closure instance. |
1323 // | 1372 // |
1324 // Provided for instance kinds: | 1373 // Provided for instance kinds: |
1325 // Closure | 1374 // Closure |
(...skipping 78 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
1404 String, | 1453 String, |
1405 | 1454 |
1406 // An instance of the built-in VM List implementation. User-defined | 1455 // An instance of the built-in VM List implementation. User-defined |
1407 // Lists will be PlainInstance. | 1456 // Lists will be PlainInstance. |
1408 List, | 1457 List, |
1409 | 1458 |
1410 // An instance of the built-in VM Map implementation. User-defined | 1459 // An instance of the built-in VM Map implementation. User-defined |
1411 // Maps will be PlainInstance. | 1460 // Maps will be PlainInstance. |
1412 Map, | 1461 Map, |
1413 | 1462 |
| 1463 // An instance of the built-in VM TypedData implementations. User-defined |
| 1464 // TypedDatas will be PlainInstance. |
| 1465 Uint8ClampedList, |
| 1466 Uint8List, |
| 1467 Uint16List, |
| 1468 Uint32List, |
| 1469 Uint64List, |
| 1470 Int8List, |
| 1471 Int16List, |
| 1472 Int32List, |
| 1473 Int64List, |
| 1474 Float32List, |
| 1475 Float64List, |
| 1476 Int32x4List, |
| 1477 Float32x4List, |
| 1478 Float64x2List, |
| 1479 |
1414 // An instance of the built-in VM Closure implementation. User-defined | 1480 // An instance of the built-in VM Closure implementation. User-defined |
1415 // Closures will be PlainInstance. | 1481 // Closures will be PlainInstance. |
1416 Closure, | 1482 Closure, |
1417 | 1483 |
1418 // An instance of the Dart class MirrorReference. | 1484 // An instance of the Dart class MirrorReference. |
1419 MirrorReference, | 1485 MirrorReference, |
1420 | 1486 |
1421 // An instance of the Dart class WeakProperty. | 1487 // An instance of the Dart class WeakProperty. |
1422 WeakProperty, | 1488 WeakProperty, |
1423 | 1489 |
(...skipping 455 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
1879 ``` | 1945 ``` |
1880 | 1946 |
1881 ## Revision History | 1947 ## Revision History |
1882 | 1948 |
1883 version | comments | 1949 version | comments |
1884 ------- | -------- | 1950 ------- | -------- |
1885 1.0 draft 1 | initial revision | 1951 1.0 draft 1 | initial revision |
1886 | 1952 |
1887 | 1953 |
1888 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss | 1954 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato
ry-discuss |
OLD | NEW |