test

• Add support for test presets. These are defined using the presets field in the package configuration file. They can be selected by passing --preset or -P, or by using the add_presets field in the package configuration file.

• Add an on_os field to the package configuration file that allows users to select different configuration for different operating systems.

• Add an on_platform field to the package configuration file that allows users to configure all tests differently depending on which platform they run on.

• Add an ios platform selector variable. This variable will only be true when the test executable itself is running on iOS, not when it's running browser tests on an iOS browser.

• Add a tags field to the package configuration file that allows users to provide configuration for specific tags.

• The --tags and --exclude-tags command-line flags now allow boolean selector syntax. For example, you can now pass --tags "(chrome || firefox) && !slow" to select quick Chrome or Firefox tests.

• Purely internal change.

• Update to shelf_web_socket 0.2.0.

• Add support for a package-level configuration file called dart_test.yaml.

• Temporarily remove separators from the help output. Version 0.12.8 was erroneously released without an appropriate args constraint for the features it used; this version will help ensure that users who can't use args 0.13.1 will get a working version of test.

• Re-add help output separators.

• Tighten the constraint on args.

• Add SuiteEvent to the JSON reporter, which reports data about the suites in which tests are run.

• Add AllSuitesEvent to the JSON reporter, which reports the total number of suites that will be run.

• Add Group.testCount to the JSON reporter, which reports the total number of tests in each group.

• Organize the --help output into sections.

• Add a --timeout flag.

• Add the ability to re-run tests while debugging. When the browser is paused at a breakpoint, the test runner will open an interactive console on the command line that can be used to restart the test.

• Add support for passing any object as a description to test() and group(). These objects will be converted to strings.

• Add the ability to tag tests. Tests with specific tags may be run by passing the --tags command-line argument, or excluded by passing the --exclude-tags parameter.

  This feature is not yet complete. For now, tags are only intended to be added temporarily to enable use-cases like focusing on a specific test or group. Further development can be followed on the issue tracker.

• Wait for a test's tear-down logic to run, even if it times out.

• Add a machine-readable JSON reporter. For details, see the protocol documentation.

• Skipped groups now properly print skip messages.

• Declare compatibility with http_multi_server 2.0.0.

• Declare compatibility with http_parser 2.0.0.

• Add setUpAll() and tearDownAll() methods that run callbacks before and after all tests in a group or suite. Note that these methods are for special cases and should be avoided—they make it very easy to accidentally introduce dependencies between tests. Use setUp() and tearDown() instead if possible.

• Allow setUp() and tearDown() to be called multiple times within the same group.

• When a tearDown() callback runs after a signal has been caught, it can now schedule out-of-band asynchronous callbacks normally rather than having them throw exceptions.

• Don't show package warnings when compiling tests with dart2js. This was accidentally enabled in 0.12.2, but was never intended.

• Fixed a deadlock bug when using setUpAll() and tearDownAll().

• Declare compatibility with Dart 1.14 and 1.15.

• Add a --pause-after-load flag that pauses the test runner after each suite is loaded so that breakpoints and other debugging annotations can be added. Currently this is only supported on browsers.

• Add a Timeout.none value indicating that a test should never time out.

• The dart-vm platform selector variable is now true for Dartium and content shell.

• The compact reporter no longer prints status lines that only update the clock if they would get in the way of messages or errors from a test.

• The expanded reporter no longer double-prints the descriptions of skipped tests.

• Require Dart SDK >= 1.11.0 and shelf >= 0.6.0, allowing test to remove various hacks and workarounds.

• Fix a memory leak when running many browser tests where old test suites failed to be unloaded when they were supposed to.

• Make source maps work properly in the browser when not using --pub-serve.

• Widen the Dart SDK constraint to include 1.13.0.

• Internal changes only.

• Fix a broken link in the README.

• Support http_parser 1.0.0.

• Don't compile tests to JavaScript when running via pub serve on Dartium or content shell.

• If a tearDown() callback throws an error, outer tearDown() callbacks are still executed.

• If a future matched against the completes or completion() matcher throws an error, that error is printed directly rather than being wrapped in a string. This allows such errors to be captured using the Zone API and improves formatting.

• Improve support for Polymer tests. This fixes a flaky time-out error and adds support for Dartifying JavaScript stack traces when running Polymer tests via pub serve.

• In order to be more extensible, all exception handling within tests now uses the Zone API.

• Add a heartbeat to reset a test's timeout whenever the test interacts with the test infrastructure.

• expect(), expectAsync(), and expectAsyncUntil() throw more useful errors if called outside a test body.

• Fix a bug that caused the test runner to crash on Windows because symlink resolution failed.

• Add a missing dependency on the collection package.

• Fix an uncaught error that could crop up when killing the test runner process at the wrong time.

• Widen the constraint on analyzer to include 0.26.0.

• Convert JavaScript stack traces into Dart stack traces using source maps. This can be disabled with the new --js-trace flag.

• Improve the browser test suite timeout logic to avoid timeouts when running many browser suites at once.

• Add a --verbose-trace flag to include core library frames in stack traces.

Test Runner

0.12.0 adds support for a test runner, which can be run via pub run test:test (or pub run test in Dart 1.10). By default it runs all files recursively in the test/ directory that end in _test.dart and aren't in a packages/ directory.

The test runner supports running tests on the Dart VM and many different browsers. Test files can use the @TestOn annotation to declare which platforms they support. For more information on this and many more new features, see the README.

Removed and Changed APIs

As part of moving to a runner-based model, most test configuration is moving out of the test file and into the runner. As such, many ancillary APIs have been removed. These APIs include skip_ and solo_ functions, Configuration and all its subclasses, TestCase, TestFunction, testConfiguration, formatStacks, filterStacks, groupSep, logMessage, testCases, BREATH_INTERVAL, currentTestCase, PASS, FAIL, ERROR, filterTests, runTests, ensureInitialized, setSoloTest, enableTest, disableTest, and withTestEnvironment.

FailureHandler, DefaultFailureHandler, configureExpectFailureHandler, and getOrCreateExpectFailureHandler which used to be exported from the matcher package have also been removed. They existed to enable integration between test and matcher that has been streamlined.

A number of APIs from matcher have been into test, including: completes, completion, ErrorFormatter, expect,fail, prints, TestFailure, Throws, and all of the throws methods. Some of these have changed slightly:

• expect no longer has a named failureHandler argument.

• expect added an optional formatter argument.

• completion argument id renamed to description.