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 353 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
364 ReturnType methodName(parameterType parameterName [optional) | 364 ReturnType methodName(parameterType parameterName [optional) |
365 ``` | 365 ``` |
366 | 366 |
367 A description of the return types and parameter types is provided | 367 A description of the return types and parameter types is provided |
368 in the section on [public types](#public-types). | 368 in the section on [public types](#public-types). |
369 | 369 |
370 ### addBreakpoint | 370 ### addBreakpoint |
371 | 371 |
372 ``` | 372 ``` |
373 Breakpoint addBreakpoint(string isolateId, | 373 Breakpoint addBreakpoint(string isolateId, |
374 string scriptId, | 374 string scriptId [optional], |
375 int line) | 375 string scriptUrl [optional], |
376 int line, | |
377 int column) | |
rmacnak
2015/09/03 00:55:19
int column [optional]
turnidge
2015/09/04 18:05:29
Done.
| |
376 ``` | 378 ``` |
377 | 379 |
378 The _addBreakpoint_ RPC is used to add a breakpoint at a specific line | 380 The _addBreakpoint_ RPC is used to add a breakpoint at a specific line |
379 of some script. | 381 of some script. |
380 | 382 |
383 The _scriptId_ or _scriptUrl_ parameter is used to specify the target | |
384 script. One of these two parameters must always be provided. | |
385 | |
386 The _line_ parameter is used to specify the target line for the | |
387 breakpoint. If there are multiple possible breakpoints on the target | |
388 line, then the VM will place the breakpoint at the location which | |
389 would execute soonest. If it is not possible to set a breakpoint at | |
390 the target line, the breakpoint will be added at the next possible | |
391 breakpoint location within the same function. | |
392 | |
393 The _column_ parameter may be optionally specified. This is useful | |
394 for targeting a specific breakpoint on a line with multiple possible | |
395 breakpoints. | |
396 | |
381 If no breakpoint is possible at that line, the _102_ (Cannot add | 397 If no breakpoint is possible at that line, the _102_ (Cannot add |
382 breakpoint) error code is returned. | 398 breakpoint) error code is returned. |
383 | 399 |
384 Note that breakpoints are added and removed on a per-isolate basis. | 400 Note that breakpoints are added and removed on a per-isolate basis. |
385 | 401 |
386 See [Breakpoint](#breakpoint). | 402 See [Breakpoint](#breakpoint). |
387 | 403 |
388 ### addBreakpointAtEntry | 404 ### addBreakpointAtEntry |
389 | 405 |
390 ``` | 406 ``` |
(...skipping 1625 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
2016 ``` | 2032 ``` |
2017 | 2033 |
2018 ## Revision History | 2034 ## Revision History |
2019 | 2035 |
2020 version | comments | 2036 version | comments |
2021 ------- | -------- | 2037 ------- | -------- |
2022 1.0 draft 1 | initial revision | 2038 1.0 draft 1 | initial revision |
2023 | 2039 |
2024 | 2040 |
2025 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato ry-discuss | 2041 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observato ry-discuss |
OLD | NEW |