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 import 'dart:async'; | 5 import 'dart:async'; |
6 | 6 |
7 import 'group.dart'; | 7 import 'group.dart'; |
8 import 'state.dart'; | 8 import 'state.dart'; |
9 import 'suite.dart'; | 9 import 'suite.dart'; |
10 import 'test.dart'; | 10 import 'test.dart'; |
11 | 11 |
12 /// A runnable instance of a test. | 12 /// A runnable instance of a test. |
13 /// | 13 /// |
14 /// This is distinct from [Test] in order to keep [Test]. Running a test | 14 /// This is distinct from [Test] in order to keep [Test] immutable. Running a |
15 /// requires state, and [LiveTest] provides a view of the state of the test as | 15 /// test requires state, and [LiveTest] provides a view of the state of the test |
16 /// it runs. | 16 /// as it runs. |
17 /// | 17 /// |
18 /// If the state changes, [state] will be updated before [onStateChange] fires. | 18 /// If the state changes, [state] will be updated before [onStateChange] fires. |
19 /// Likewise, if an error is caught, it will be added to [errors] before being | 19 /// Likewise, if an error is caught, it will be added to [errors] before being |
20 /// emitted via [onError]. If an error causes a state change, [onStateChange] | 20 /// emitted via [onError]. If an error causes a state change, [onStateChange] |
21 /// will fire before [onError]. If an error or other state change causes the | 21 /// will fire before [onError]. If an error or other state change causes the |
22 /// test to complete, [onComplete] will complete after [onStateChange] and | 22 /// test to complete, [onComplete] will complete after [onStateChange] and |
23 /// [onError] fire. | 23 /// [onError] fire. |
24 abstract class LiveTest { | 24 abstract class LiveTest { |
25 /// The suite within which this test is being run. | 25 /// The suite within which this test is being run. |
26 Suite get suite; | 26 Suite get suite; |
(...skipping 111 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
138 /// | 138 /// |
139 /// This doesn't automatically happen after the test completes because there | 139 /// This doesn't automatically happen after the test completes because there |
140 /// may be more asynchronous work going on in the background that could | 140 /// may be more asynchronous work going on in the background that could |
141 /// produce new errors. | 141 /// produce new errors. |
142 /// | 142 /// |
143 /// Returns a [Future] that completes once all resources are released *and* | 143 /// Returns a [Future] that completes once all resources are released *and* |
144 /// the test has completed. This allows the caller to wait until the test's | 144 /// the test has completed. This allows the caller to wait until the test's |
145 /// tear-down logic has run. | 145 /// tear-down logic has run. |
146 Future close(); | 146 Future close(); |
147 } | 147 } |
OLD | NEW |