OLD | NEW |
1 `test` provides a standard way of writing and running tests in Dart. | 1 `test` provides a standard way of writing and running tests in Dart. |
2 | 2 |
3 * [Writing Tests](#writing-tests) | 3 * [Writing Tests](#writing-tests) |
4 * [Running Tests](#running-tests) | 4 * [Running Tests](#running-tests) |
5 * [Restricting Tests to Certain Platforms](#restricting-tests-to-certain-platf
orms) | 5 * [Restricting Tests to Certain Platforms](#restricting-tests-to-certain-platf
orms) |
6 * [Platform Selectors](#platform-selectors) | 6 * [Platform Selectors](#platform-selectors) |
7 * [Running Tests on Dartium](#running-tests-on-dartium) | 7 * [Running Tests on Dartium](#running-tests-on-dartium) |
8 * [Asynchronous Tests](#asynchronous-tests) | 8 * [Asynchronous Tests](#asynchronous-tests) |
9 * [Running Tests With Custom HTML](#running-tests-with-custom-html) | 9 * [Running Tests With Custom HTML](#running-tests-with-custom-html) |
10 * [Configuring Tests](#configuring-tests) | 10 * [Configuring Tests](#configuring-tests) |
(...skipping 510 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
521 [package configuration file][configuring tags], it'll print a warning, so be | 521 [package configuration file][configuring tags], it'll print a warning, so be |
522 sure to include all your tags there. You can also use the file to provide | 522 sure to include all your tags there. You can also use the file to provide |
523 default configuration for tags, like giving all `browser` tests twice as much | 523 default configuration for tags, like giving all `browser` tests twice as much |
524 time before they time out. | 524 time before they time out. |
525 | 525 |
526 [configuring tags]: https://github.com/dart-lang/test/blob/master/doc/package_co
nfig.md#configuring-tags | 526 [configuring tags]: https://github.com/dart-lang/test/blob/master/doc/package_co
nfig.md#configuring-tags |
527 | 527 |
528 Tests can be filtered based on their tags by passing command line flags. The | 528 Tests can be filtered based on their tags by passing command line flags. The |
529 `--tags` or `-t` flag will cause the test runner to only run tests with the | 529 `--tags` or `-t` flag will cause the test runner to only run tests with the |
530 given tags, and the `--exclude-tags` or `-x` flag will cause it to only run | 530 given tags, and the `--exclude-tags` or `-x` flag will cause it to only run |
531 tests *without* the given tags. | 531 tests *without* the given tags. These flags also support |
| 532 [boolean selector syntax][]. For example, you can pass `--tags "(chrome || |
| 533 firefox) && !slow"` to select quick Chrome or Firefox tests. |
532 | 534 |
533 Note that tags must be valid Dart identifiers, although they may also contain | 535 Note that tags must be valid Dart identifiers, although they may also contain |
534 hyphens. | 536 hyphens. |
535 | 537 |
536 ### Whole-Package Configuration | 538 ### Whole-Package Configuration |
537 | 539 |
538 For configuration that applies across multiple files, or even the entire | 540 For configuration that applies across multiple files, or even the entire |
539 package, `test` supports a configuration file called `dart_test.yaml`. At its | 541 package, `test` supports a configuration file called `dart_test.yaml`. At its |
540 simplest, this file can contain the same sort of configuration that can be | 542 simplest, this file can contain the same sort of configuration that can be |
541 passed as command-line arguments: | 543 passed as command-line arguments: |
(...skipping 95 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
637 available to tests. | 639 available to tests. |
638 | 640 |
639 [api]: http://www.dartdocs.org/documentation/test/latest/index.html | 641 [api]: http://www.dartdocs.org/documentation/test/latest/index.html |
640 | 642 |
641 The test runner also supports a machine-readable JSON-based reporter. This | 643 The test runner also supports a machine-readable JSON-based reporter. This |
642 reporter allows the test runner to be wrapped and its progress presented in | 644 reporter allows the test runner to be wrapped and its progress presented in |
643 custom ways (for example, in an IDE). See [the protocol documentation][json] for | 645 custom ways (for example, in an IDE). See [the protocol documentation][json] for |
644 more details. | 646 more details. |
645 | 647 |
646 [json]: https://github.com/dart-lang/test/blob/master/doc/json_reporter.md | 648 [json]: https://github.com/dart-lang/test/blob/master/doc/json_reporter.md |
OLD | NEW |