OLD | NEW |
---|---|
1 Each package may include a configuration file that applies to the package as a | 1 Each package may include a configuration file that applies to the package as a |
2 whole. This file can be used to provide custom defaults for various options, to | 2 whole. This file can be used to provide custom defaults for various options, to |
3 define configuration for multiple files, and more. | 3 define configuration for multiple files, and more. |
4 | 4 |
5 The file is named `dart_test.yaml` and lives at the root of the package, next to | 5 The file is named `dart_test.yaml` and lives at the root of the package, next to |
6 the package's pubspec. Like the pubspec, it's a [YAML][] file. Here's an | 6 the package's pubspec. Like the pubspec, it's a [YAML][] file. Here's an |
7 example: | 7 example: |
8 | 8 |
9 [YAML]: http://yaml.org/ | 9 [YAML]: http://yaml.org/ |
10 | 10 |
(...skipping 15 matching lines...) Expand all Loading... | |
26 | 26 |
27 * [Test Configuration](#test-configuration) | 27 * [Test Configuration](#test-configuration) |
28 * [`timeout`](#timeout) | 28 * [`timeout`](#timeout) |
29 * [`verbose_trace`](#verbose_trace) | 29 * [`verbose_trace`](#verbose_trace) |
30 * [`js_trace`](#js_trace) | 30 * [`js_trace`](#js_trace) |
31 * [`skip`](#skip) | 31 * [`skip`](#skip) |
32 * [`test_on`](#test_on) | 32 * [`test_on`](#test_on) |
33 * [Runner Configuration](#runner-configuration) | 33 * [Runner Configuration](#runner-configuration) |
34 * [`paths`](#paths) | 34 * [`paths`](#paths) |
35 * [`filename`](#filename) | 35 * [`filename`](#filename) |
36 * [`names`](#names) | |
37 * [`plain_names`](#plain_names) | |
36 * [`platforms`](#platforms) | 38 * [`platforms`](#platforms) |
37 * [`concurrency`](#concurrency) | 39 * [`concurrency`](#concurrency) |
38 * [`pub_serve`](#pub_serve) | 40 * [`pub_serve`](#pub_serve) |
39 * [`reporter`](#reporter) | 41 * [`reporter`](#reporter) |
40 * [Configuring Tags](#configuring-tags) | 42 * [Configuring Tags](#configuring-tags) |
41 * [`tags`](#tags) | 43 * [`tags`](#tags) |
42 * [`add_tags`](#add_tags) | 44 * [`add_tags`](#add_tags) |
43 * [Configuring Platforms](#configuring-platforms) | 45 * [Configuring Platforms](#configuring-platforms) |
44 * [`on_os`](#on_os) | 46 * [`on_os`](#on_os) |
45 * [`on_platform`](#on_platform) | 47 * [`on_platform`](#on_platform) |
(...skipping 128 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
174 This supports the full [glob syntax][]. However, since it's only compared | 176 This supports the full [glob syntax][]. However, since it's only compared |
175 against a path's basename, path separators aren't especially useful. It defaults | 177 against a path's basename, path separators aren't especially useful. It defaults |
176 to `"*_test.dart"`. | 178 to `"*_test.dart"`. |
177 | 179 |
178 ```yaml | 180 ```yaml |
179 filename: "test_*.dart" | 181 filename: "test_*.dart" |
180 ``` | 182 ``` |
181 | 183 |
182 [glob syntax]: https://github.com/dart-lang/glob#syntax | 184 [glob syntax]: https://github.com/dart-lang/glob#syntax |
183 | 185 |
186 ### `names` | |
187 | |
188 This field restricts the tests run by the runner to those whose names match the | |
189 given regular expressions. A test's name must match *all* regular expressions in | |
190 `names`, as well as containing all strings in [`plain_names`](#plain_names), in | |
191 order to be run. | |
192 | |
193 This is usually used in a [preset](#configuration-presets) to make it possible | |
194 to quickly select a given set of tests. | |
195 | |
196 ```yaml | |
197 presets: | |
198 # Pass "-P chrome" to run only Chrome tests. | |
199 chrome: | |
200 names: | |
201 - "^browser:" | |
202 - "[Cc]hrome" | |
203 ``` | |
204 | |
205 ### `plain_names` | |
206 | |
207 This field restricts the tests run by the runner to those whose names contain | |
208 the given strings. A test's name must contain *all* strings in `plain_names`, as | |
209 well as matching all regular expressions in [`names`](#names), in order to be | |
210 run. | |
211 | |
212 This is usually used in a [preset](#configuration-presets) to make it possible | |
213 to quickly select a given set of tests. | |
214 | |
215 ```yaml | |
216 presets: | |
217 # Pass "-P ie" to run only Internet Explorer tests. | |
218 ie: | |
219 names: | |
kevmoo
2016/03/14 23:08:47
should be `plain_names:` ?
nweiz
2016/03/14 23:20:24
Done.
| |
220 - "IE" | |
221 - "Internet Explorer" | |
222 ``` | |
223 | |
184 ### `platforms` | 224 ### `platforms` |
185 | 225 |
186 This field indicates which platforms tests should run on by default. It allows | 226 This field indicates which platforms tests should run on by default. It allows |
187 the same platform identifiers that can be passed to `--platform`. If multiple | 227 the same platform identifiers that can be passed to `--platform`. If multiple |
188 platforms are included, the test runner will default to running tests on all of | 228 platforms are included, the test runner will default to running tests on all of |
189 them. This defaults to `[vm]`. | 229 them. This defaults to `[vm]`. |
190 | 230 |
191 ```yaml | 231 ```yaml |
192 platforms: [content_shell] | 232 platforms: [content_shell] |
193 | 233 |
(...skipping 234 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
428 presets: | 468 presets: |
429 # Shortcut for running only browser tests. | 469 # Shortcut for running only browser tests. |
430 browser: | 470 browser: |
431 paths: [test/runner/browser] | 471 paths: [test/runner/browser] |
432 | 472 |
433 # Shortcut for running only Chrome tests. | 473 # Shortcut for running only Chrome tests. |
434 chrome: | 474 chrome: |
435 filename: "chrome_*_test.dart" | 475 filename: "chrome_*_test.dart" |
436 add_presets: [browser] | 476 add_presets: [browser] |
437 ``` | 477 ``` |
OLD | NEW |