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 | 22 /// Returns the value of [when]. Some debuggers may display [message]. |
23 /// display [msg]. | |
24 /// | 23 /// |
25 /// NOTE: When invoked, the isolate will not return until a debugger | 24 /// NOTE: When invoked, the isolate will not return until a debugger |
26 /// continues execution. When running in the Dart VM the behaviour is the same | 25 /// continues execution. When running in the Dart VM the behaviour is the same |
27 /// regardless of whether or not a debugger is connected. When compiled to | 26 /// regardless of whether or not a debugger is connected. When compiled to |
28 /// JavaScript, this uses the "debugger" statement, and behaves exactly as | 27 /// JavaScript, this uses the "debugger" statement, and behaves exactly as |
29 /// that does. | 28 /// that does. |
30 external bool debugger({bool when: true, String msg}); | 29 external bool debugger({bool when: true, String message}); |
31 | 30 |
32 /// Send a reference to [object] to any attached debuggers. | 31 /// Send a reference to [object] to any attached debuggers. |
33 /// | 32 /// |
34 /// Debuggers may open an inspector on the object. Returns the argument. | 33 /// Debuggers may open an inspector on the object. Returns the argument. |
35 external inspect(object); | 34 external Object inspect(Object object); |
36 | 35 |
37 /// Emit a log event. | 36 /// 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 |