Flutter Test Runners #

Widget test runners for Flutter apps and packages.

Write tests that run on a specified platform.

testWidgetsOnMac("My test", (tester) async {
  // This test runs with a simulated Mac platform.
});

testWidgetsOnIos("My test", (tester) async {
  // This test runs with a simulated iOS platform.
});

testWidgetsOnAndroid("My test", (tester) async {
  // This test runs with a simulated Android platform.
});

Write tests that run on multiple simulated platforms.

testWidgetsOnMobile("My test", (tester) async {
  // This test runs once on iOS and once on Android.
});

testWidgetsOnDesktop("My test", (tester) async {
  // This test runs once on Mac, once on Windows, and once on Linux.
});

Platform test runners are especially useful when you want to test a platform-specific behavior, such as a platform-specific keyboard shortcut. For example, a desktop app can test a "copy" shortcut with the help of flutter_test_robots.

testWidgetsOnMac("My shortcut test", (tester) async {
  // Setup the test.

  await tester.pressCmdC();

  // Verify the results of the copy command.
});