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 17 matching lines...) Expand all Loading... |
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) | 36 * [`names`](#names) |
37 * [`plain_names`](#plain_names) | 37 * [`plain_names`](#plain_names) |
| 38 * [`include_tags`](#include_tags) |
| 39 * [`exclude_tags`](#exclude_tags) |
38 * [`platforms`](#platforms) | 40 * [`platforms`](#platforms) |
39 * [`concurrency`](#concurrency) | 41 * [`concurrency`](#concurrency) |
40 * [`pub_serve`](#pub_serve) | 42 * [`pub_serve`](#pub_serve) |
41 * [`reporter`](#reporter) | 43 * [`reporter`](#reporter) |
42 * [Configuring Tags](#configuring-tags) | 44 * [Configuring Tags](#configuring-tags) |
43 * [`tags`](#tags) | 45 * [`tags`](#tags) |
44 * [`add_tags`](#add_tags) | 46 * [`add_tags`](#add_tags) |
45 * [Configuring Platforms](#configuring-platforms) | 47 * [Configuring Platforms](#configuring-platforms) |
46 * [`on_os`](#on_os) | 48 * [`on_os`](#on_os) |
47 * [`on_platform`](#on_platform) | 49 * [`on_platform`](#on_platform) |
(...skipping 130 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
178 to `"*_test.dart"`. | 180 to `"*_test.dart"`. |
179 | 181 |
180 ```yaml | 182 ```yaml |
181 filename: "test_*.dart" | 183 filename: "test_*.dart" |
182 ``` | 184 ``` |
183 | 185 |
184 [glob syntax]: https://github.com/dart-lang/glob#syntax | 186 [glob syntax]: https://github.com/dart-lang/glob#syntax |
185 | 187 |
186 ### `names` | 188 ### `names` |
187 | 189 |
188 This field restricts the tests run by the runner to those whose names match the | 190 This field causes the runner to only run tests whose names match the given |
189 given regular expressions. A test's name must match *all* regular expressions in | 191 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 | 192 `names`, as well as containing all strings in [`plain_names`](#plain_names), in |
191 order to be run. | 193 order to be run. |
192 | 194 |
193 This is usually used in a [preset](#configuration-presets) to make it possible | 195 This is usually used in a [preset](#configuration-presets) to make it possible |
194 to quickly select a given set of tests. | 196 to quickly select a given set of tests. |
195 | 197 |
196 ```yaml | 198 ```yaml |
197 presets: | 199 presets: |
198 # Pass "-P chrome" to run only Chrome tests. | 200 # Pass "-P chrome" to run only Chrome tests. |
199 chrome: | 201 chrome: |
200 names: | 202 names: |
201 - "^browser:" | 203 - "^browser:" |
202 - "[Cc]hrome" | 204 - "[Cc]hrome" |
203 ``` | 205 ``` |
204 | 206 |
205 ### `plain_names` | 207 ### `plain_names` |
206 | 208 |
207 This field restricts the tests run by the runner to those whose names contain | 209 This field causes the runner to only run tests whose names contain the given |
208 the given strings. A test's name must contain *all* strings in `plain_names`, as | 210 strings. A test's name must contain *all* strings in `plain_names`, as well as |
209 well as matching all regular expressions in [`names`](#names), in order to be | 211 matching all regular expressions in [`names`](#names), in order to be run. |
210 run. | |
211 | 212 |
212 This is usually used in a [preset](#configuration-presets) to make it possible | 213 This is usually used in a [preset](#configuration-presets) to make it possible |
213 to quickly select a given set of tests. | 214 to quickly select a given set of tests. |
214 | 215 |
215 ```yaml | 216 ```yaml |
216 presets: | 217 presets: |
217 # Pass "-P ie" to run only Internet Explorer tests. | 218 # Pass "-P ie" to run only Internet Explorer tests. |
218 ie: | 219 ie: |
219 plain_names: | 220 plain_names: |
220 - "IE" | 221 - "IE" |
221 - "Internet Explorer" | 222 - "Internet Explorer" |
222 ``` | 223 ``` |
223 | 224 |
| 225 ### `include_tags` |
| 226 |
| 227 This field causes the runner to only run tests whose tags match the given |
| 228 [boolean selector][]. If both `include_tags` and [`exclude_tags`](#exclude_tags) |
| 229 are used, the exclusions take precedence. |
| 230 |
| 231 [boolean selector]: https://github.com/dart-lang/boolean_selector/blob/master/RE
ADME.md |
| 232 |
| 233 This is usually used in a [preset](#configuration-preset) to make it possible to |
| 234 quickly select a set of tests. |
| 235 |
| 236 ```yaml |
| 237 presets: |
| 238 # Pass "-P windowless" to run tests that don't open browser windows. |
| 239 windowless: |
| 240 include_tags: !browser || content-shell |
| 241 ``` |
| 242 |
| 243 ### `exclude_tags` |
| 244 |
| 245 This field causes the runner not to run tests whose tags match the given |
| 246 [boolean selector][]. If both [`include_tags`](#include_tags) and `exclude_tags` |
| 247 are used, the exclusions take precedence. |
| 248 |
| 249 This is usually used in a [preset](#configuration-preset) to make it possible to |
| 250 quickly select a set of tests. |
| 251 |
| 252 ```yaml |
| 253 presets: |
| 254 # Pass "-P windowless" to run tests that don't open browser windows. |
| 255 windowless: |
| 256 exclude_tags: browser && !content-shell |
| 257 ``` |
| 258 |
224 ### `platforms` | 259 ### `platforms` |
225 | 260 |
226 This field indicates which platforms tests should run on by default. It allows | 261 This field indicates which platforms tests should run on by default. It allows |
227 the same platform identifiers that can be passed to `--platform`. If multiple | 262 the same platform identifiers that can be passed to `--platform`. If multiple |
228 platforms are included, the test runner will default to running tests on all of | 263 platforms are included, the test runner will default to running tests on all of |
229 them. This defaults to `[vm]`. | 264 them. This defaults to `[vm]`. |
230 | 265 |
231 ```yaml | 266 ```yaml |
232 platforms: [content_shell] | 267 platforms: [content_shell] |
233 | 268 |
(...skipping 234 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
468 presets: | 503 presets: |
469 # Shortcut for running only browser tests. | 504 # Shortcut for running only browser tests. |
470 browser: | 505 browser: |
471 paths: [test/runner/browser] | 506 paths: [test/runner/browser] |
472 | 507 |
473 # Shortcut for running only Chrome tests. | 508 # Shortcut for running only Chrome tests. |
474 chrome: | 509 chrome: |
475 filename: "chrome_*_test.dart" | 510 filename: "chrome_*_test.dart" |
476 add_presets: [browser] | 511 add_presets: [browser] |
477 ``` | 512 ``` |
OLD | NEW |