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 library test.runner.environment; | 5 library test.runner.environment; |
6 | 6 |
7 import '../util/cancelable_future.dart'; | 7 import 'package:async/async.dart'; |
8 | 8 |
9 /// The abstract class of environments in which test suites are | 9 /// The abstract class of environments in which test suites are |
10 /// loaded—specifically, browsers and the Dart VM. | 10 /// loaded—specifically, browsers and the Dart VM. |
11 abstract class Environment { | 11 abstract class Environment { |
12 /// The URL of the Dart VM Observatory for this environment, or `null` if this | 12 /// The URL of the Dart VM Observatory for this environment, or `null` if this |
13 /// environment doesn't run the Dart VM or the URL couldn't be detected. | 13 /// environment doesn't run the Dart VM or the URL couldn't be detected. |
14 Uri get observatoryUrl; | 14 Uri get observatoryUrl; |
15 | 15 |
16 /// The URL of the remote debugger for this environment, or `null` if it isn't | 16 /// The URL of the remote debugger for this environment, or `null` if it isn't |
17 /// enabled. | 17 /// enabled. |
18 Uri get remoteDebuggerUrl; | 18 Uri get remoteDebuggerUrl; |
19 | 19 |
20 /// Displays information indicating that the test runner is paused. | 20 /// Displays information indicating that the test runner is paused. |
21 /// | 21 /// |
22 /// The returned future will complete when the user takes action within the | 22 /// The returned operation will complete when the user takes action within the |
23 /// environment that should unpause the runner. If the runner is unpaused | 23 /// environment that should unpause the runner. If the runner is unpaused |
24 /// elsewhere, the future should be canceled. | 24 /// elsewhere, the operation should be canceled. |
25 CancelableFuture displayPause(); | 25 CancelableOperation displayPause(); |
26 } | 26 } |
OLD | NEW |