← Flutter / Dart

Flutter / Dart · 19 / 24

AsyncNotifier: Laden, Fehler und Wiederholung

Du prüfst einen fehlgeschlagenen Lesevorgang und einen ausdrücklich ausgelösten zweiten Versuch.

  • Groß
  • Anspruchsvoll
  • 90 min

Voraussetzungen: Null Safety, Fehler und Future, Riverpod: Zustand beobachten und verändern, Clean MVVM, Services und Repositories

In diesem Tutorial
  1. Die Grenze festlegen
  2. Das Lernprojekt einrichten
  3. Den Erfolgsfall nachvollziehen
  4. Fehler bewusst beobachten
  5. Die Erweiterung selbst lösen
  6. Die Lösung vergleichen
  7. Übung und Lösung
  8. Projektbezug und Quellen

Lernpaket herunterladen

Einrichtung und Prüfstand

Flutter ab 3.41.5 mit Dart 3.11. Zusätzlich Python 3 für den gemeinsamen Prüfstart. Entpacke das Lernpaket in einen neuen Ordner und führe dort python3 run_checks.py aus. Das Skript kopiert die enthaltenen Dateien in einen temporären Lernordner. Dort prüft es zuerst das Beispiel und danach die mitgelieferte Lösung. Die Ausgangsdateien bleiben erhalten. Benötigte Pakete werden beim ersten Lauf aus dem Netz geladen.

Geprüft am 20.10.2026 unter Linux x86_64. Der Fake schlägt beim ersten Lesen fehl und liefert beim zweiten Versuch Daten. Prüfe den Wechsel von Fehler zu Daten und die Zahl der Repository-Aufrufe.

Asynchroner Zustand hat mehr als einen gültigen Wert. Eine Oberfläche muss auch Warten und Fehler erklären. Der Provider besitzt die Zustandsmaschine. Ein Repository liefert Daten oder einen Fehler. In diesem Lernprojekt ist automatische Wiederholung ausgeschaltet, damit jeder Test genau einen Versuch beobachten kann.

Paketinhalt und einzelne Dateien

01Die Grenze festlegen

AsyncValue trennt Laden, Daten und Fehler. Der Notifier kapselt den Leseauftrag. Die Oberfläche entscheidet anhand dieses Zustands, welche Meldung und welcher Wiederholungsbutton sichtbar sind. Die Sperre verhindert zwei parallele Wiederholungen.

lib/model.dart · dartDatei öffnen
import 'package:flutter_riverpod/flutter_riverpod.dart';

abstract interface class VehicleReader {
  Future<List<String>> read();
}

class DemoReader implements VehicleReader {
  int attempts = 0;
  @override
  Future<List<String>> read() async {
    attempts++;
    if (attempts == 1) throw StateError('Storage unavailable');
    return ['Family car'];
  }
}

final readerProvider = Provider<VehicleReader>((ref) => DemoReader());
final vehiclesProvider = AsyncNotifierProvider<Vehicles, List<String>>(
  Vehicles.new,
  retry: (_, _) => null,
);

class Vehicles extends AsyncNotifier<List<String>> {
  @override
  Future<List<String>> build() => ref.watch(readerProvider).read();
  Future<void> retry() async {
    state = const AsyncLoading();
    state = await AsyncValue.guard(() => ref.read(readerProvider).read());
  }
}

02Das Lernprojekt einrichten

Die Abhängigkeiten sind direkt fixiert. Entpacke alle Dateien zusammen und starte flutter pub get. Verwende für Tests keine bestehende App-Datenbank. Die Testfälle erzeugen ihre eigenen Daten und räumen sie wieder auf.

pubspec.yaml · yamlDatei öffnen
name: learning_example
publish_to: none
environment:
  sdk: ">=3.11.0 <4.0.0"
dependencies:
  flutter:
    sdk: flutter
  flutter_riverpod: 3.3.1
  drift: 2.33.0
  path_provider: 2.1.5
dev_dependencies:
  flutter_test:
    sdk: flutter
flutter:
  uses-material-design: true

03Den Erfolgsfall nachvollziehen

Der Fake schlägt beim ersten Lesen fehl und liefert beim zweiten Versuch Daten. Prüfe den Wechsel von Fehler zu Daten und die Zahl der Repository-Aufrufe.

test/model_test.dart · dartDatei öffnen
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:learning_example/model.dart';

void main() {
  test(
    'failed read can be retried without recreating the repository',
    () async {
      final reader = DemoReader();
      final container = ProviderContainer(
        overrides: [readerProvider.overrideWithValue(reader)],
      );
      addTearDown(container.dispose);
      expect(container.read(vehiclesProvider).isLoading, isTrue);
      await expectLater(
        container.read(vehiclesProvider.future),
        throwsStateError,
      );
      expect(reader.attempts, 1);
      expect(container.read(vehiclesProvider).hasError, isTrue);
      await container.read(vehiclesProvider.notifier).retry();
      expect(container.read(vehiclesProvider).requireValue, ['Family car']);
      expect(reader.attempts, 2);
    },
  );
}

Starten / prüfen

flutter pub get
flutter test
Erwartetes Ergebnis

Der Fake schlägt beim ersten Lesen fehl und liefert beim zweiten Versuch Daten. Prüfe den Wechsel von Fehler zu Daten und die Zahl der Repository-Aufrufe.

04Fehler bewusst beobachten

Ändere eine erwartete Zahl oder einen erwarteten Zustand im Test. flutter test muss fehlschlagen. Stelle danach die richtige Erwartung wieder her. Unterscheide eine fachliche Abweichung von einem fehlenden Plugin oder einer fehlenden Entwicklungsumgebung.

05Die Erweiterung selbst lösen

Ergänze einen zweiten Datensatz und prüfe, dass nach Wiederholung beide angezeigt werden.

06Die Lösung vergleichen

Der Repository-Vertrag bleibt unverändert. Die Lösung erweitert den bestätigten Wert und prüft dessen gesamte Reihenfolge. Ein Fehler bleibt ein Fehler und wird nicht als leere Liste ausgegeben.

Erwartetes Ergebnis

flutter test besteht für Ausgangsbeispiel und ergänzte Lösung.

Deine Übung

Ergänze einen zweiten Datensatz und prüfe, dass nach Wiederholung beide angezeigt werden.

Lösung mit Erklärung anzeigen

Der Repository-Vertrag bleibt unverändert. Die Lösung erweitert den bestätigten Wert und prüft dessen gesamte Reihenfolge. Ein Fehler bleibt ein Fehler und wird nicht als leere Liste ausgegeben.

solution/model_test.dart · dartDatei öffnen
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:learning_example/model.dart';

void main() {
  test(
    'failed read can be retried without recreating the repository',
    () async {
      final reader = ExtendedReader();
      final container = ProviderContainer(
        overrides: [readerProvider.overrideWithValue(reader)],
      );
      addTearDown(container.dispose);
      expect(container.read(vehiclesProvider).isLoading, isTrue);
      await expectLater(
        container.read(vehiclesProvider.future),
        throwsStateError,
      );
      expect(reader.attempts, 1);
      expect(container.read(vehiclesProvider).hasError, isTrue);
      await container.read(vehiclesProvider.notifier).retry();
      expect(container.read(vehiclesProvider).requireValue, [
        'Family car',
        'Motorbike',
      ]);
      expect(reader.attempts, 2);
    },
  );
}

class ExtendedReader extends DemoReader {
  @override
  Future<List<String>> read() async {
    final rows = await super.read();
    return [...rows, 'Motorbike'];
  }
}

Projektbezug und Quellen

Das eigenständige Lernprojekt vertieft ein Thema aus diesem Technologiebereich. Die Projektverweise zeigen einen festgehaltenen Quellstand als Architekturkontext. Sie sind kein Beleg dafür, dass jede hier neu eingeführte Bibliothek oder Funktion bereits in dieser App verwendet wird.