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.
Dieses HttpClient-Beispiel benötigt ein natives Dart-Ziel. Es läuft nicht unverändert im Web.
Geprüft am 20.10.2026 unter Linux x86_64. Ein lokaler HTTP-Server liefert echte JSON-Antworten. Die Tests prüfen Seiten, ungültige Antworten und den Abbruch. Ein Browser benötigt stattdessen einen passenden Web-Transport.
Ein Future abzuwarten beendet keine alte Netzwerkanfrage. Unser nativer Dart-Client besitzt pro Abruf einen HttpClient und kann ihn gezielt schließen. Der Server liefert einen Cursor für die nächste Seite. Die Tests verwenden einen echten lokalen HttpServer und eine absichtlich verzögerte Antwort. Dieses dart:io-Beispiel ist für native Plattformen gedacht.
Paketinhalt und einzelne Dateien
01Die Grenze festlegen
Eine Seitennummer gehört zum Request und zum Ergebnis. Der Parser prüft die Antwortstruktur vor der Übernahme. Ein eigener HttpClient pro Operation erlaubt den Abbruch über close. Diese dart:io-Variante richtet sich an native Flutter-Ziele.
import 'dart:convert';
import 'dart:io';
class PageResult {
PageResult(this.items, this.next);
final List<String> items;
final int? next;
}
class Cancelled implements Exception {}
class PageRequest {
final HttpClient _client = HttpClient();
bool _cancelled = false;
void cancel() {
_cancelled = true;
_client.close(force: true);
}
Future<PageResult> load(Uri uri) async {
if (_cancelled) throw Cancelled();
try {
final response = await (await _client.getUrl(uri)).close();
if (response.statusCode != 200)
throw HttpException('HTTP ${response.statusCode}');
final data = jsonDecode(await utf8.decoder.bind(response).join());
if (data is! Map<String, dynamic> ||
data['items'] is! List ||
!(data['items'] as List).every((x) => x is String) ||
(data['next'] != null && data['next'] is! int)) {
throw const FormatException('Invalid page');
}
if (_cancelled) throw Cancelled();
return PageResult(
List<String>.from(data['items'] as List),
data['next'] as int?,
);
} catch (_) {
if (_cancelled) throw Cancelled();
rethrow;
} finally {
_client.close(force: true);
}
}
}
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.
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
Ein lokaler HTTP-Server liefert echte JSON-Antworten. Die Tests prüfen Seiten, ungültige Antworten und den Abbruch. Ein Browser benötigt stattdessen einen passenden Web-Transport.
import 'dart:async';
import 'dart:io';
import 'package:flutter_test/flutter_test.dart';
import 'package:learning_example/model.dart';
void main() {
test(
'two pages, invalid JSON and cancellation use a real HTTP boundary',
() async {
final server = await HttpServer.bind(InternetAddress.loopbackIPv4, 0);
addTearDown(() => server.close(force: true));
final waiting = Completer<void>();
server.listen((request) async {
if (request.uri.path == '/slow') {
waiting.complete();
return;
}
request.response.headers.contentType = ContentType.json;
request.response.write(
request.uri.path == '/bad'
? '{"items":[12]}'
: request.uri.queryParameters['page'] == '2'
? '{"items":["B"],"next":null}'
: '{"items":["A"],"next":2}',
);
await request.response.close();
});
final base = Uri.parse('http://127.0.0.1:${server.port}');
final first = await PageRequest().load(base);
final second = await PageRequest().load(
base.replace(queryParameters: {'page': '${first.next}'}),
);
expect([...first.items, ...second.items], ['A', 'B']);
expect(second.next, isNull);
await expectLater(
PageRequest().load(base.resolve('/bad')),
throwsFormatException,
);
final request = PageRequest();
final done = expectLater(
request.load(base.resolve('/slow')),
throwsA(isA<Cancelled>()),
);
await waiting.future.timeout(const Duration(seconds: 3));
request.cancel();
await done;
},
);
}
Starten / prüfen
flutter pub get
flutter testEin lokaler HTTP-Server liefert echte JSON-Antworten. Die Tests prüfen Seiten, ungültige Antworten und den Abbruch. Ein Browser benötigt stattdessen einen passenden Web-Transport.
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
Prüfe auch den Abbruch vor dem Start einer Anfrage.
06Die Lösung vergleichen
Nach cancel darf load keinen Netzwerkanruf mehr beginnen. Der zusätzliche Test erwartet denselben fachlichen Abbruchtyp. Für eine Oberfläche sollten alte Antworten außerdem anhand ihrer Anfrageidentität verworfen werden.
flutter test besteht für Ausgangsbeispiel und ergänzte Lösung.
Deine Übung
Prüfe auch den Abbruch vor dem Start einer Anfrage.
Lösung mit Erklärung anzeigen
Nach cancel darf load keinen Netzwerkanruf mehr beginnen. Der zusätzliche Test erwartet denselben fachlichen Abbruchtyp. Für eine Oberfläche sollten alte Antworten außerdem anhand ihrer Anfrageidentität verworfen werden.
import 'dart:async';
import 'dart:io';
import 'package:flutter_test/flutter_test.dart';
import 'package:learning_example/model.dart';
void main() {
test('cancel before load', () async {
final request = PageRequest()..cancel();
await expectLater(
request.load(Uri.parse('http://127.0.0.1:1')),
throwsA(isA<Cancelled>()),
);
});
test(
'two pages, invalid JSON and cancellation use a real HTTP boundary',
() async {
final server = await HttpServer.bind(InternetAddress.loopbackIPv4, 0);
addTearDown(() => server.close(force: true));
final waiting = Completer<void>();
server.listen((request) async {
if (request.uri.path == '/slow') {
waiting.complete();
return;
}
request.response.headers.contentType = ContentType.json;
request.response.write(
request.uri.path == '/bad'
? '{"items":[12]}'
: request.uri.queryParameters['page'] == '2'
? '{"items":["B"],"next":null}'
: '{"items":["A"],"next":2}',
);
await request.response.close();
});
final base = Uri.parse('http://127.0.0.1:${server.port}');
final first = await PageRequest().load(base);
final second = await PageRequest().load(
base.replace(queryParameters: {'page': '${first.next}'}),
);
expect([...first.items, ...second.items], ['A', 'B']);
expect(second.next, isNull);
await expectLater(
PageRequest().load(base.resolve('/bad')),
throwsFormatException,
);
final request = PageRequest();
final done = expectLater(
request.load(base.resolve('/slow')),
throwsA(isA<Cancelled>()),
);
await waiting.future.timeout(const Duration(seconds: 3));
request.cancel();
await done;
},
);
}
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.