flutter_driver_extension_extensions 0.0.4
flutter_driver_extension_extensions: ^0.0.4 copied to clipboard

Flutter driver extensions.

flutter_driver_extension_extensions #

Flutter package to enhance Flutter Driver possibilities with Finder Extensions and Command Extensions.

Rationale #

Flutter Driver enables test instrumentation from any language or framework. And so this extensions. The case is different for integration tests package, which only allows test cases to be written from dart (in general).

Getting Started #

Assuming you're already using Flutter Driver, you can go straight to point 2.

1. Turn On Flutter Driver #

Follow an introduction to integration testing steps.

2. Attach Flutter Driver Extensions #

In test_driver/app.dart (or any your test driver application file) add import:

import 'package:flutter_driver_extension_extensions/flutter_driver_extension_factories.dart';

In the same file, call enableFlutterDriverExtension with the new command and finders arguments:

    // +++
    commands: commandExtensions,
    finders: finderExtensions,
    // +++

3. Use Extensions From Tests File #

In test_driver/app_test.dart add import:

import 'package:flutter_driver_extension_extensions/flutter_driver_extensions.dart';

And start using extensions:

group("E2E Tests", () {
    setUpAll(() async {
        driver = await FlutterDriver.connect();

    tearDownAll(() async {
        await driver.close();

    test("longPress", () async {
        await driver.longPress(find.byValueKey("button"));

    test("getChildrenCount", () async {
        final count = await driver.getChildrenCount(find.byValueKey("row"));
        expect(count, 7);

    test("atFirst finder", () async {
        final count = await driver.waitFor(find.byType("MaterialButton").atFirst());
        expect(count, 7);

Available extensions #

The package adds extension functions on Driver object and finders.

driver is the object returned by driver = await FlutterDriver.connect(); finder is one of find.byText(...), find.byType(...) etc. Could be used as an argument of command (e.g. waitFor)


  • driver.getValueKey(finder) - returns a Key value of single element found by finder (tip: it must be only one available)
  • driver.getCount(finder) - returns a number of elements matched by the given finder (e.g. number of MaterialButtons in the row)
  • driver.getChildrenCount(finder) - returns a number of direct children inside a component found by finder
  • driver.getInnerText(finder) - returns a "text" of any component that has children with


  • finder.at(n) - finds an element at nth place
  • finder.atFirst() - finds only first element
  • finder.atLast() - finds the last element

For the complete use case check our E2E tests.