OLD | NEW |
1 // Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file |
2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 /// Interact with developer tools such as the debugger and inspector. | 5 /// Interact with developer tools such as the debugger and inspector. |
6 /// | 6 /// |
7 /// The dart:developer library is _unstable_ and its API might change slightly | 7 /// The dart:developer library is _unstable_ and its API might change slightly |
8 /// as a result of developer feedback. This library is platform dependent and | 8 /// as a result of developer feedback. This library is platform dependent and |
9 /// therefore it has implementations for both dart2js and the Dart VM. Both are | 9 /// therefore it has implementations for both dart2js and the Dart VM. Both are |
10 /// under development and may not support all operations yet. | 10 /// under development and may not support all operations yet. |
11 /// | 11 /// |
12 library dart.developer; | 12 library dart.developer; |
13 | 13 |
14 import 'dart:async'; | 14 import 'dart:async'; |
15 import 'dart:convert'; | 15 import 'dart:convert'; |
16 | 16 |
17 part 'profiler.dart'; | 17 part 'profiler.dart'; |
18 | 18 |
19 /// If [when] is true, stop the program as if a breakpoint were hit at the | 19 /// If [when] is true, stop the program as if a breakpoint were hit at the |
20 /// following statement. | 20 /// following statement. |
21 /// | 21 /// |
22 /// Returns the value of [when]. Some debuggers may display [message]. | 22 /// Returns the value of [when]. Some debuggers may |
| 23 /// display [msg]. |
23 /// | 24 /// |
24 /// NOTE: When invoked, the isolate will not return until a debugger | 25 /// NOTE: When invoked, the isolate will not return until a debugger |
25 /// continues execution. When running in the Dart VM the behaviour is the same | 26 /// continues execution. When running in the Dart VM the behaviour is the same |
26 /// regardless of whether or not a debugger is connected. When compiled to | 27 /// regardless of whether or not a debugger is connected. When compiled to |
27 /// JavaScript, this uses the "debugger" statement, and behaves exactly as | 28 /// JavaScript, this uses the "debugger" statement, and behaves exactly as |
28 /// that does. | 29 /// that does. |
29 external bool debugger({bool when: true, String message}); | 30 external bool debugger({bool when: true, String msg}); |
30 | 31 |
31 /// Send a reference to [object] to any attached debuggers. | 32 /// Send a reference to [object] to any attached debuggers. |
32 /// | 33 /// |
33 /// Debuggers may open an inspector on the object. Returns the argument. | 34 /// Debuggers may open an inspector on the object. Returns the argument. |
34 external Object inspect(Object object); | 35 external inspect(object); |
35 | 36 |
36 /// Emit a log event. | 37 /// Emit a log event. |
37 /// | |
38 /// [sequenceNumber] is a monotonically increasing sequence number. | 38 /// [sequenceNumber] is a monotonically increasing sequence number. |
39 /// [millisececondsSinceEpoch] is a timestamp. | 39 /// [millisececondsSinceEpoch] is a timestamp. |
40 /// [level] is the severity level (value between 0 and 2000 inclusive). | 40 /// [level] is the severity level (value between 0 and 2000 inclusive). |
41 /// [name] is the name of the source of the log message. | 41 /// [name] is the name of the source of the log message. |
42 /// [message] is the log message. | 42 /// [message] is the log message. |
43 /// [zone] (optional) the zone where the log was emitted | 43 /// [zone] (optional) the zone where the log was emitted |
44 /// [error] (optional) an error object associated with this log event. | 44 /// [error] (optional) an error object associated with this log event. |
45 /// [stackTrace] (optional) a stack trace associated with this log event. | 45 /// [stackTrace] (optional) a stack trace associated with this log event. |
46 external log({int sequenceNumber, | 46 external log({int sequenceNumber, |
47 int millisecondsSinceEpoch, | 47 int millisecondsSinceEpoch, |
48 int level, | 48 int level, |
49 String name, | 49 String name, |
50 String message, | 50 String message, |
51 Zone zone, | 51 Zone zone, |
52 Object error, | 52 Object error, |
53 StackTrace stackTrace}); | 53 StackTrace stackTrace}); |
OLD | NEW |