dart test
The dart test
command runs tests that rely on the test
package and are under the test
directory of the current Dart project. For information on writing tests, see the testing documentation. If you're working on Flutter code, then use the flutter test
command instead, as described in Testing Flutter apps.
Here's an example of using dart test
to run all tests that are under the current project's test
directory:
$ cd my_app
$ dart test
To control which tests run, you can add the paths to directories or files under the test
directory:
$ dart test test/library_tour/io_test.dart
00:00 +0: readAsString, readAsLines
00:00 +1: readAsBytes
...
Another way to run a subset of tests is to use the --name
(-n
), --tags
(-t
), or --exclude-tags
(-x
) flag, adding part or all of the string to match:
$ dart test --name String
00:00 +0: test/library_tour/io_test.dart: readAsString, readAsLines
00:00 +1: test/library_tour/core_test.dart: print: print(nonString)
00:00 +2: test/library_tour/core_test.dart: print: print(String)
00:00 +3: test/library_tour/core_test.dart: numbers: toString()
...
When you use these flags more than once in the same command line, only the tests that match all the conditions run:
$ dart test --name String --name print
00:00 +0: test/library_tour/core_test.dart: print: print(nonString)
00:00 +1: test/library_tour/core_test.dart: print: print(String)
00:00 +2: All tests passed!
The dart test
command has many more flags to control which tests run, how they run (for example, concurrency and timeout), and where and how the output appears. For further information on command-line options, see the test
package or use the --help
flag:
$ dart test --help
Unless stated otherwise, the documentation on this site reflects Dart 3.6.0. Page last updated on 2024-05-06. View source or report an issue.