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 482 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
493 Both the annotation and the parameter take a map. The map's keys are [platform | 493 Both the annotation and the parameter take a map. The map's keys are [platform |
494 selectors](#platform-selector-syntax) which describe the platforms for which the | 494 selectors](#platform-selector-syntax) which describe the platforms for which the |
495 specialized configuration applies. Its values are instances of some of the same | 495 specialized configuration applies. Its values are instances of some of the same |
496 annotation classes that can be used for a suite: `Skip` and `Timeout`. A value | 496 annotation classes that can be used for a suite: `Skip` and `Timeout`. A value |
497 can also be a list of these values. | 497 can also be a list of these values. |
498 | 498 |
499 If multiple platforms match, the configuration is applied in order from first to | 499 If multiple platforms match, the configuration is applied in order from first to |
500 last, just as they would in nested groups. This means that for configuration | 500 last, just as they would in nested groups. This means that for configuration |
501 like duration-based timeouts, the last matching value wins. | 501 like duration-based timeouts, the last matching value wins. |
502 | 502 |
| 503 You can also set up global platform-specific configuration using the |
| 504 [package configuration file][configuring platforms]. |
| 505 |
| 506 [configuring platforms]: https://github.com/dart-lang/test/blob/master/doc/packa
ge_config.md#configuring-platforms |
| 507 |
503 ### Tagging Tests | 508 ### Tagging Tests |
504 | 509 |
505 Tags are short strings that you can associate with tests, groups, and suites. | 510 Tags are short strings that you can associate with tests, groups, and suites. |
506 They don't have any built-in meaning, but they're very useful nonetheless: you | 511 They don't have any built-in meaning, but they're very useful nonetheless: you |
507 can associate your own custom configuration with them, or you can use them to | 512 can associate your own custom configuration with them, or you can use them to |
508 easily filter tests so you only run the ones you need to. | 513 easily filter tests so you only run the ones you need to. |
509 | 514 |
510 Tags are defined using the `@Tags` annotation for suites and the `tags` named | 515 Tags are defined using the `@Tags` annotation for suites and the `tags` named |
511 parameter to `test()` and `group()`. For example: | 516 parameter to `test()` and `group()`. For example: |
512 | 517 |
(...skipping 135 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
648 available to tests. | 653 available to tests. |
649 | 654 |
650 [api]: http://www.dartdocs.org/documentation/test/latest/index.html | 655 [api]: http://www.dartdocs.org/documentation/test/latest/index.html |
651 | 656 |
652 The test runner also supports a machine-readable JSON-based reporter. This | 657 The test runner also supports a machine-readable JSON-based reporter. This |
653 reporter allows the test runner to be wrapped and its progress presented in | 658 reporter allows the test runner to be wrapped and its progress presented in |
654 custom ways (for example, in an IDE). See [the protocol documentation][json] for | 659 custom ways (for example, in an IDE). See [the protocol documentation][json] for |
655 more details. | 660 more details. |
656 | 661 |
657 [json]: https://github.com/dart-lang/test/blob/master/doc/json_reporter.md | 662 [json]: https://github.com/dart-lang/test/blob/master/doc/json_reporter.md |
OLD | NEW |