Terakhir diperbarui: 9 November 2026
Fitur yang berjalan di satu perangkat belum tentu bebas dari masalah. Melalui codelab ini, Anda akan berlatih menulis pengujian yang membantu memeriksa perilaku aplikasi, menemukan regresi, dan menjaga kualitas kode saat aplikasi berkembang.
Setelah menyelesaikan codelab ini, Anda diharapkan mampu:
flutter create testing_lab.| Jenis | Yang diperiksa | Contoh |
|---|---|---|
| Unit | Satu fungsi atau objek tanpa merender UI | Validasi judul tugas atau aturan bisnis |
| Widget | Tampilan dan interaksi satu atau beberapa widget | Form menampilkan pesan saat input tidak valid |
| Integrasi | Alur aplikasi dari awal hingga akhir pada perangkat atau emulator | Pengguna menambah tugas dan melihatnya di daftar |
Pengujian unit biasanya paling cepat dan mudah diperbaiki. Pengujian widget memeriksa UI tanpa perlu menjalankan aplikasi pada perangkat. Pengujian integrasi mencakup alur yang lebih utuh, tetapi waktu eksekusi dan pemeliharaannya lebih besar.
Logika bisnis yang bercampur langsung dengan widget dan akses jaringan sulit diuji secara terpisah. Pisahkan tanggung jawab: widget menangani tampilan dan interaksi, sedangkan repository menangani sumber data. Berikan repository melalui konstruktor atau abstraksi agar pengujian dapat menggantinya dengan data tiruan yang terkendali.
Contoh berikut memeriksa aturan sederhana: judul tugas harus berisi teks setelah spasi di awal dan akhir diabaikan.
bool isValidTaskTitle(String value) {
return value.trim().isNotEmpty;
}
Buat file test/is_valid_task_title_test.dart. Paket flutter_test sudah tersedia dalam project Flutter.
import 'package:flutter_test/flutter_test.dart';
import 'package:testing_lab/is_valid_task_title.dart';
void main() {
group('isValidTaskTitle', () {
test('menerima judul yang berisi teks', () {
expect(isValidTaskTitle('Belajar Flutter'), isTrue);
});
test('menolak teks kosong atau hanya spasi', () {
expect(isValidTaskTitle(''), isFalse);
expect(isValidTaskTitle(' '), isFalse);
});
});
}
Sesuaikan nama package pada baris import dengan nama project Anda di pubspec.yaml.
expect.Tambahkan kasus tepi yang relevan, misalnya masukan kosong, spasi saja, nilai batas, atau kegagalan yang mungkin terjadi. Jangan hanya menguji kasus yang diperkirakan berhasil.
Jangan mengandalkan API sungguhan dalam pengujian unit. Jaringan, autentikasi, dan isi server dapat berubah, sehingga pengujian menjadi lambat atau tidak konsisten. Definisikan kontrak kecil untuk kebutuhan fitur:
abstract interface class TaskRepository {
Future<List<String>> getTasks();
}
class TaskService {
TaskService(this._repository);
final TaskRepository _repository;
Future<List<String>> loadTasks() {
return _repository.getTasks();
}
}
Fake adalah implementasi sederhana yang perilakunya dikendalikan pengujian. Dengan fake, Anda dapat memeriksa hasil sukses maupun kegagalan tanpa koneksi internet.
class FakeTaskRepository implements TaskRepository {
FakeTaskRepository({this.tasks = const [], this.error});
final List<String> tasks;
final Exception? error;
@override
Future<List<String>> getTasks() async {
if (error != null) throw error!;
return tasks;
}
}
test('meneruskan data dari repository', () async {
final service = TaskService(
FakeTaskRepository(tasks: ['Baca materi']),
);
expect(await service.loadTasks(), ['Baca materi']);
});
Tambahkan pengujian kegagalan untuk memastikan error tidak berubah diam-diam menjadi daftar kosong. Pilih penanganan error yang memang dijanjikan oleh rancangan aplikasi.
Pengujian widget berjalan dengan flutter_test. Gunakan pumpWidget untuk merender UI, lalu cari elemen dengan find dan periksa kondisi yang terlihat oleh pengguna.
testWidgets('menampilkan judul halaman tugas', (tester) async {
await tester.pumpWidget(
const MaterialApp(
home: Scaffold(
body: Text('Daftar tugas'),
),
),
);
expect(find.text('Daftar tugas'), findsOneWidget);
});
Untuk menguji form atau tombol, masukkan teks dengan enterText, tekan kontrol dengan tap, lalu panggil pump atau pumpAndSettle agar perubahan UI selesai dirender.
await tester.enterText(
find.byKey(const Key('task-title-field')),
'Baca materi',
);
await tester.tap(find.byKey(const Key('save-task-button')));
await tester.pumpAndSettle();
expect(find.text('Baca materi'), findsOneWidget);
Berikan Key pada kontrol jika pencarian berdasarkan teks atau tipe widget tidak cukup jelas. Uji juga keadaan penting seperti input tidak valid, indikator loading, data kosong, dan pesan error.
Pengujian integrasi memeriksa beberapa bagian aplikasi yang bekerja bersama. Flutter menyediakan paket integration_test. Jika belum ada, tambahkan pada bagian dev_dependencies di pubspec.yaml, lalu jalankan flutter pub get:
dev_dependencies:
integration_test:
sdk: flutter
Letakkan pengujian di integration_test/app_test.dart dan gunakan binding berikut:
import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';
import 'package:testing_lab/main.dart' as app;
void main() {
IntegrationTestWidgetsFlutterBinding.ensureInitialized();
testWidgets('pengguna dapat menambahkan tugas', (tester) async {
app.main();
await tester.pumpAndSettle();
await tester.enterText(
find.byKey(const Key('task-title-field')),
'Baca materi',
);
await tester.tap(find.byKey(const Key('save-task-button')));
await tester.pumpAndSettle();
expect(find.text('Baca materi'), findsOneWidget);
});
}
Sesuaikan kunci widget dengan aplikasi Anda. Jalankan pengujian pada emulator atau perangkat yang aktif:
flutter test integration_test/app_test.dart -d <device_id>
Setelah menemukan dan memperbaiki bug, tambahkan pengujian yang gagal sebelum perbaikan dan lulus sesudahnya. Jalankan seluruh suite secara berkala dengan flutter test, bukan hanya pengujian yang baru ditulis.
Gunakan fitur utama project Anda. Jika belum ada, buat fitur daftar tugas sederhana. Tujuannya adalah menguji perilaku dari logika hingga alur aplikasi, bukan mengejar jumlah pengujian sebanyak-banyaknya.
group.flutter test, flutter test integration_test/app_test.dart -d <device_id>, dan flutter analyze. Perbaiki kegagalan sebelum melanjutkan.Jika sebuah pengujian gagal, baca keluaran yang menunjukkan pengujian serta kondisi yang tidak terpenuhi. Pastikan penyebabnya bukan karena urutan test, data bersama, atau ketergantungan pada jaringan.
Untuk menghasilkan laporan cakupan pengujian unit dan widget, jalankan:
flutter test --coverage
Angka cakupan menunjukkan bagian kode yang dijalankan saat pengujian, bukan jaminan bahwa semua perilaku sudah diperiksa. Tinjau cabang penting dan kasus tepi; jangan menambah pengujian yang tidak memeriksa hasil hanya demi menaikkan persentase.
flutter test, hasil analisis, dan temuan yang belum terselesaikan di README.md.