メインコンテンツにスキップ

dart test

dart test コマンドは、test パッケージに依存する、現在の Dart プロジェクトの test ディレクトリの下にあるテストを実行します。テストの書き方については、テストのドキュメントを参照してください。Flutter コードを扱っている場合は、Flutter アプリのテストで説明されているように、代わりに flutter test コマンドを使用してください。

現在のプロジェクトの test ディレクトリの下にあるすべてのテストを実行する dart test の使用例を以下に示します。

cd my_app
dart test

実行するテストを制御するには、test ディレクトリの下のディレクトリまたはファイルへのパスを追加できます。

dart test test/library_tour/io_test.dart
00:00 +0: readAsString, readAsLines
00:00 +1: readAsBytes
...

テストのサブセットを実行する別の方法は、--name (-n)、--tags (-t)、または --exclude-tags (-x) フラグを使用し、一致させる文字列の一部または全体を追加することです。

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()
...

これらのフラグを同じコマンドラインで複数回使用すると、すべての条件に一致するテストのみが実行されます。

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!

dart test コマンドには、どのテストを実行するか、どのように実行するか (たとえば、並列処理やタイムアウト)、および出力がどこにどのように表示されるかを制御するためのフラグがさらに多数あります。コマンドラインオプションの詳細については、test パッケージを参照するか、--help フラグを使用してください。

dart test --help