OLD | NEW |
---|---|
1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2013, 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 /// This library is used for testing asynchronous tests. | 5 /// This library is used for testing asynchronous tests. |
6 /// If a test is asynchronous, it needs to notify the testing driver | 6 /// If a test is asynchronous, it needs to notify the testing driver |
7 /// about this (otherwise tests may get reported as passing [after main() | 7 /// about this (otherwise tests may get reported as passing [after main() |
8 /// finished] even if the asynchronous operations fail). | 8 /// finished] even if the asynchronous operations fail). |
9 /// Tests which can't use the unittest framework should use the helper functions | 9 /// Tests which can't use the unittest framework should use the helper functions |
10 /// in this library. | 10 /// in this library. |
11 /// This library provides four methods | 11 /// This library provides four methods |
12 /// - asyncStart(): Needs to be called before an asynchronous operation is | 12 /// - asyncStart(): Needs to be called before an asynchronous operation is |
13 /// scheduled. | 13 /// scheduled. |
14 /// - asyncEnd(): Needs to be called as soon as the asynchronous operation | 14 /// - asyncEnd(): Needs to be called as soon as the asynchronous operation |
15 /// ended. | 15 /// ended. |
16 /// - asyncSuccess(_): Variant of asyncEnd useful together with Future.then. | 16 /// - asyncSuccess(_): Variant of asyncEnd useful together with Future.then. |
17 /// - asyncTest(f()): Helper method that wraps a computation that returns a | 17 /// - asyncTest(f()): Helper method that wraps a computation that returns a |
18 /// Future with matching calls to asyncStart() and | 18 /// Future with matching calls to asyncStart() and |
19 /// asyncSuccess(_). | 19 /// asyncSuccess(_). |
20 /// After the last asyncStart() called was matched with a corresponding | 20 /// After the last asyncStart() called was matched with a corresponding |
21 /// asyncEnd() or asyncSuccess(_) call, the testing driver will be notified that | 21 /// asyncEnd() or asyncSuccess(_) call, the testing driver will be notified that |
22 /// the tests is done. | 22 /// the tests is done. |
23 | 23 |
24 library async_helper; | 24 library async_helper; |
25 | 25 |
26 // TODO(kustermann): This is problematic because we rely on a working | 26 bool _initialized = false; |
27 // 'dart:isolate' (i.e. it is in particular problematic with dart2js). | 27 Function _onAsyncEnd; |
vsm
2015/08/19 15:02:35
Perhaps give this a signature / typedef to avoid t
Jennifer Messerly
2015/08/19 15:34:44
Done.
fwiw, this method won't really appear on st
| |
28 // It would be nice if we could use a different mechanism for different | |
29 // runtimes. | |
30 import 'dart:isolate'; | |
31 | 28 |
32 bool _initialized = false; | |
33 ReceivePort _port = null; | |
34 int _asyncLevel = 0; | 29 int _asyncLevel = 0; |
35 | 30 |
36 Exception _buildException(String msg) { | 31 Exception _buildException(String msg) { |
37 return new Exception('Fatal: $msg. This is most likely a bug in your test.'); | 32 return new Exception('Fatal: $msg. This is most likely a bug in your test.'); |
38 } | 33 } |
39 | 34 |
35 /// Implementation method called from language_tests.js. | |
36 /// Registers the callback that will be used complete the test. | |
37 void asyncTestInitialize(void callback()) { | |
38 _asyncLevel = 0; | |
39 _initialized = false; | |
40 _onAsyncEnd = callback; | |
41 } | |
42 | |
43 /// Implementation method called from language_tests.js. | |
44 /// Returns true if an asyncTest was started. | |
45 bool get asyncTestStarted => _initialized; | |
46 | |
40 /// Call this method before an asynchronous test is created. | 47 /// Call this method before an asynchronous test is created. |
41 void asyncStart() { | 48 void asyncStart() { |
42 if (_initialized && _asyncLevel == 0) { | 49 if (_initialized && _asyncLevel == 0) { |
43 throw _buildException('asyncStart() was called even though we are done ' | 50 throw _buildException('asyncStart() was called even though we are done ' |
44 'with testing.'); | 51 'with testing.'); |
45 } | 52 } |
46 if (!_initialized) { | 53 if (!_initialized) { |
54 if (_onAsyncEnd == null) { | |
55 throw _buildException( | |
56 'asyncStart() was called before asyncTestInitialize()'); | |
57 } | |
58 | |
47 print('unittest-suite-wait-for-done'); | 59 print('unittest-suite-wait-for-done'); |
48 _initialized = true; | 60 _initialized = true; |
49 _port = new ReceivePort(); | 61 |
50 } | 62 } |
51 _asyncLevel++; | 63 _asyncLevel++; |
52 } | 64 } |
53 | 65 |
54 /// Call this after an asynchronous test has ended successfully. | 66 /// Call this after an asynchronous test has ended successfully. |
55 void asyncEnd() { | 67 void asyncEnd() { |
56 if (_asyncLevel <= 0) { | 68 if (_asyncLevel <= 0) { |
57 if (!_initialized) { | 69 if (!_initialized) { |
58 throw _buildException('asyncEnd() was called before asyncStart().'); | 70 throw _buildException('asyncEnd() was called before asyncStart().'); |
59 } else { | 71 } else { |
60 throw _buildException('asyncEnd() was called more often than ' | 72 throw _buildException('asyncEnd() was called more often than ' |
61 'asyncStart().'); | 73 'asyncStart().'); |
62 } | 74 } |
63 } | 75 } |
64 _asyncLevel--; | 76 _asyncLevel--; |
65 if (_asyncLevel == 0) { | 77 if (_asyncLevel == 0) { |
66 _port.close(); | 78 var callback = _onAsyncEnd; |
67 _port = null; | 79 _onAsyncEnd = null; |
80 callback(); | |
68 print('unittest-suite-success'); | 81 print('unittest-suite-success'); |
69 } | 82 } |
70 } | 83 } |
71 | 84 |
72 /** | 85 /** |
73 * Call this after an asynchronous test has ended successfully. This is a helper | 86 * Call this after an asynchronous test has ended successfully. This is a helper |
74 * for calling [asyncEnd]. | 87 * for calling [asyncEnd]. |
75 * | 88 * |
76 * This method intentionally has a signature that matches [:Future.then:] as a | 89 * This method intentionally has a signature that matches [:Future.then:] as a |
77 * convenience for calling [asyncEnd] when a [:Future:] completes without error, | 90 * convenience for calling [asyncEnd] when a [:Future:] completes without error, |
78 * like this: | 91 * like this: |
79 * | 92 * |
80 * asyncStart(); | 93 * asyncStart(); |
81 * Future result = test(); | 94 * Future result = test(); |
82 * result.then(asyncSuccess); | 95 * result.then(asyncSuccess); |
83 */ | 96 */ |
84 void asyncSuccess(_) => asyncEnd(); | 97 void asyncSuccess(_) => asyncEnd(); |
85 | 98 |
86 /** | 99 /** |
87 * Helper method for performing asynchronous tests involving [:Future:]. | 100 * Helper method for performing asynchronous tests involving [:Future:]. |
88 * | 101 * |
89 * [f] must return a [:Future:] for the test computation. | 102 * [f] must return a [:Future:] for the test computation. |
90 */ | 103 */ |
91 void asyncTest(f()) { | 104 void asyncTest(f()) { |
92 asyncStart(); | 105 asyncStart(); |
93 f().then(asyncSuccess); | 106 f().then(asyncSuccess); |
94 } | 107 } |
OLD | NEW |