測試 UI 層

#

判斷一個架構是否健全的一種方式是考慮應用程式的測試難易程度。由於 ViewModel 和 View 具有明確定義的輸入,它們的依賴項可以輕鬆被模擬(mocked)或偽造(faked),並且可以輕鬆編寫單元測試。

ViewModel 單元測試

#

要測試 ViewModel 的 UI 邏輯,您應該編寫不依賴於 Flutter 庫或測試框架的單元測試。

儲存庫(Repositories)是 ViewModel 唯一的依賴項(除非您正在實現用例(use-cases)),您只需要對儲存庫編寫模擬(mocks)偽造(fakes)。在此示例測試中,使用了名為FakeBookingRepository的偽造類。

home_screen_test.dart
dart
void main() {
  group('HomeViewModel tests', () {
    test('Load bookings', () {
      // HomeViewModel._load is called in the constructor of HomeViewModel.
      final viewModel = HomeViewModel(
        bookingRepository: FakeBookingRepository()
          ..createBooking(kBooking),
        userRepository: FakeUserRepository(),
      );

      expect(viewModel.bookings.isNotEmpty, true);
    });
  });
}

FakeBookingRepository 類實現了BookingRepository。在此案例研究的資料層部分,對BookingRepository類進行了詳細解釋。

fake_booking_repository.dart
dart
class FakeBookingRepository implements BookingRepository {
  List<Booking> bookings = List.empty(growable: true);

  @override
  Future<Result<void>> createBooking(Booking booking) async {
    bookings.add(booking);
    return Result.ok(null);
  }
  // ...
}

View 部件測試

#

一旦您為 ViewModel 編寫了測試,您就已經建立了編寫部件測試所需的偽造物件。以下示例展示瞭如何使用HomeViewModel和所需的儲存庫來設定HomeScreen的部件測試。

home_screen_test.dart
dart
void main() {
  group('HomeScreen tests', () {
    late HomeViewModel viewModel;
    late MockGoRouter goRouter;
    late FakeBookingRepository bookingRepository;

    setUp(() {
      bookingRepository = FakeBookingRepository()
        ..createBooking(kBooking);
      viewModel = HomeViewModel(
        bookingRepository: bookingRepository,
        userRepository: FakeUserRepository(),
      );
      goRouter = MockGoRouter();
      when(() => goRouter.push(any())).thenAnswer((_) => Future.value(null));
    });

    // ...
  });
}

此設定建立了兩個所需的偽造儲存庫,並將它們傳遞給HomeViewModel物件。此類不需要被偽造。

在定義了 ViewModel 及其依賴項之後,需要建立將被測試的部件樹。在HomeScreen的測試中,定義了一個loadWidget方法。

home_screen_test.dart
dart
void main() {
  group('HomeScreen tests', () {
    late HomeViewModel viewModel;
    late MockGoRouter goRouter;
    late FakeBookingRepository bookingRepository;

    setUp(
      // ...
    );

    void loadWidget(WidgetTester tester) async {
      await testApp(
        tester,
        ChangeNotifierProvider.value(
          value: FakeAuthRepository() as AuthRepository,
          child: Provider.value(
            value: FakeItineraryConfigRepository() as ItineraryConfigRepository,
            child: HomeScreen(viewModel: viewModel),
          ),
        ),
        goRouter: goRouter,
      );
    }

    // ...
  });
}

此方法接著呼叫testApp,這是一個用於 compass 應用所有部件測試的通用方法。它的樣子如下:

testing/app.dart
dart
void testApp(
  WidgetTester tester,
  Widget body, {
  GoRouter? goRouter,
}) async {
  tester.view.devicePixelRatio = 1.0;
  await tester.binding.setSurfaceSize(const Size(1200, 800));
  await mockNetworkImages(() async {
    await tester.pumpWidget(
      MaterialApp(
        localizationsDelegates: [
          GlobalWidgetsLocalizations.delegate,
          GlobalMaterialLocalizations.delegate,
          AppLocalizationDelegate(),
        ],
        theme: AppTheme.lightTheme,
        home: InheritedGoRouter(
          goRouter: goRouter ?? MockGoRouter(),
          child: Scaffold(
            body: body,
          ),
        ),
      ),
    );
  });
}

此函式唯一的作用是建立一個可供測試的部件樹。

loadWidget方法傳入了部件樹中獨有的部分進行測試。在這種情況下,包括HomeScreen及其 ViewModel,以及位於部件樹更上層的附加偽造儲存庫。

最重要的一點是,只要您的架構健全,檢視和 ViewModel 測試僅需要模擬儲存庫。

測試資料層

#

與 UI 層類似,資料層的元件也具有明確定義的輸入和輸出,使得雙方都可以被偽造。要為任何給定的儲存庫編寫單元測試,請模擬它所依賴的服務。以下示例展示了BookingRepository的單元測試。

booking_repository_remote_test.dart
dart
void main() {
  group('BookingRepositoryRemote tests', () {
    late BookingRepository bookingRepository;
    late FakeApiClient fakeApiClient;

    setUp(() {
      fakeApiClient = FakeApiClient();
      bookingRepository = BookingRepositoryRemote(
        apiClient: fakeApiClient,
      );
    });

    test('should get booking', () async {
      final result = await bookingRepository.getBooking(0);
      final booking = result.asOk.value;
      expect(booking, kBooking);
    });
  });
}

要了解有關編寫模擬和偽造的更多資訊,請檢視Compass App testing 目錄中的示例,或閱讀Flutter 的測試文件

反饋

#

本網站的此部分正在不斷完善中,我們歡迎您的反饋