Flutter WidgetTester에서 TabBar 테스트는 탭 글자가 화면에 보이는지만 확인하면 부족하다. 스마트홈 앱에서는 ‘기기 상태’와 ‘예약’ 탭이 서로 다른 TabBarView를 보여주고, MQTT 스트림도 선택된 화면에 맞춰 표시한다. 처음에는 find.text('예약')를 찾은 뒤 바로 상태를 검사했는데, 실제로는 탭 인덱스만 바뀌고 애니메이션 프레임이 끝나지 않아 테스트가 간헐적으로 실패했다.
탭 자체와 화면 내용을 분리해 확인한다
테스트 대상은 실제 MQTT 브로커가 아니라 탭 전환 계약이다. 브로커 연결을 함께 넣으면 네트워크 지연과 탭 애니메이션 중 어느 쪽이 실패했는지 알기 어렵다. 화면은 선택된 탭에 따라 Key가 있는 본문을 렌더링하도록 단순화했다.
class SmartHomeTabs extends StatelessWidget {
const SmartHomeTabs({super.key, required this.onTabChanged});
final ValueChanged<int> onTabChanged;
@override
Widget build(BuildContext context) {
return DefaultTabController(
length: 2,
child: Builder(
builder: (context) => Column(
children: [
TabBar(
onTap: onTabChanged,
tabs: const [
Tab(key: Key('devices-tab'), text: '기기 상태'),
Tab(key: Key('schedule-tab'), text: '예약'),
],
),
const Expanded(
child: TabBarView(
children: [
Center(child: Text('MQTT 연결 기기', key: Key('device-view'))),
Center(child: Text('난방 예약', key: Key('schedule-view'))),
],
),
),
],
),
),
);
}
}
여기서 onTap은 탭을 눌렀다는 이벤트만 알려준다. 실제 본문은 TabBarView 애니메이션을 거쳐 바뀌므로, 콜백이 호출됐다는 사실과 새 화면이 나타났다는 사실을 같은 expect로 처리하지 않는 편이 안전하다.
tap → pump → pumpAndSettle을 구분한다
아래 테스트는 MQTT 서비스 대신 선택된 탭 인덱스만 기록한다. pump()는 탭 입력을 반영하고, pumpAndSettle()은 기본 탭 전환 애니메이션이 끝날 때까지 프레임을 진행한다.
testWidgets('스마트홈 대시보드에서 예약 탭으로 전환한다', (tester) async {
final selectedIndexes = <int>[];
await tester.pumpWidget(
MaterialApp(
home: Scaffold(
body: SmartHomeTabs(
onTabChanged: selectedIndexes.add,
),
),
),
);
expect(find.byKey(const Key('device-view')), findsOneWidget);
expect(find.byKey(const Key('schedule-view')), findsNothing);
await tester.tap(find.byKey(const Key('schedule-tab')));
await tester.pump();
await tester.pumpAndSettle();
expect(selectedIndexes, [1]);
expect(find.byKey(const Key('schedule-view')), findsOneWidget);
expect(find.byKey(const Key('device-view')), findsNothing);
});
pumpAndSettle()을 무조건 쓰는 것도 답은 아니다. 탭 화면 안에서 MQTT 구독처럼 계속 살아 있는 애니메이션이나 주기적 타이머가 실행되면 settle되지 않아 테스트가 멈출 수 있다. 그런 화면은 다음처럼 고정 시간만 진행하고, 본문이 바뀌었는지 검사한다.
await tester.tap(find.byKey(const Key('schedule-tab')));
await tester.pump(const Duration(milliseconds: 350));
expect(find.byKey(const Key('schedule-view')), findsOneWidget);
실제로 헷갈렸던 실패 지점
| 증상 | 원인 | 수정 기준 |
|---|---|---|
| 탭 콜백은 호출됐는데 본문이 이전 화면이다 | 전환 애니메이션 프레임 미진행 | pump() 후 pumpAndSettle() 또는 고정 시간 pump() |
pumpAndSettle()이 끝나지 않는다 |
반복 타이머·MQTT 스트림이 계속 동작 | Fake 시간 또는 제한된 pump(Duration) 사용 |
| 같은 텍스트가 두 개 발견된다 | 탭 라벨과 본문 문구가 중복됨 | Key 또는 find.byType(Tab)로 범위 축소 |
| 첫 탭에서 테스트가 불안정하다 | DefaultTabController를 만든 직후 상태 검사 |
초기 pumpWidget 뒤 현재 탭을 명시적으로 확인 |
탭 테스트에서 가장 큰 실수는 화면 전환을 네트워크 테스트처럼 다루는 것이다. MQTT 메시지가 도착했을 때 선택된 탭에 상태가 표시되는지까지 검증하려면, Fake 스트림이 이벤트를 한 번만 내보내도록 만들고 탭 전환 테스트와 상태 반영 테스트를 분리하는 편이 결과를 읽기 쉽다.
짧게 정리하면, TabBar는 라벨이 아니라 탭 인덱스와 TabBarView의 결과를 함께 확인해야 한다. 애니메이션이 있는 기본 화면은 pumpAndSettle(), 계속 움직이는 MQTT 화면은 제한된 pump(Duration)을 선택하면 실패 원인이 훨씬 선명해진다.