flutter_page_object 0.0.5+2

Helps to implement the Page Object pattern in a Flutter app.

flutter_page_object

flutter_page_object is a Flutter library allowing to write page objects for your application using the PageObject pattern. Using it make your tests easier to write, read and maintain.

Usage

See example for a complete example.

Your tests will look like this:

testWidgets('form completed and tap login button --> navigates to home page', (t) async {
  await t.pumpWidget(const MaterialApp(home: LoginPage()));
  final loginPage = LoginPageObject(t);

  await loginPage.completeForm();
  expect(loginPage.loginButton.isEnabled, isTrue);
  final homePage = await loginPage.loginButton.tapNavAndSettle();

  expect(homePage, findsOne);
  expect(homePage.greetingText, findsOne);
});

While the page object will look like this:

class LoginPageObject extends PageObject {
  late final username = d.byKey.stringTextFormField(const Key('username'));
  late final password = d.byKey.stringTextFormField(const Key('password'));
  late final loginButton =
      d.byKey.navButton(const Key('login_button'), HomePageObject(t));

  LoginPageObject(WidgetTester t) : super(t, _finder);

  Future<void> completeForm() async {
    await username.setText('username');
    await password.setText('password');
    await t.pump();
  }
}

Creating your own page object

You can create your own page object by simply extending the PageObject base class.