fake_api: Support preparing a queue of responses.

An issue that exists prior to this change is that there can be unused
prepared responses when the test ends, but we don't have a way to detect
that. We can potentially do something like what testWidgets does with
pending timers.

Signed-off-by: Zixuan James Li <[email protected]>

Author: PIG208

test/api/fake_api.dart

@@ -1,3 +1,4 @@
+import 'dart:collection';
 import 'dart:convert';
 
 import 'package:flutter/foundation.dart';
@@ -37,10 +38,9 @@ class FakeHttpClient extends http.BaseClient {
     return result;
   }
 
-  _PreparedResponse? _nextResponse;
+  final Queue<_PreparedResponse> _preparedResponses = Queue();
 
-  // Please add more features to this mocking API as needed.  For example:
-  //  * preparing more than one request, and logging more than one request
+  // Please add more features to this mocking API as needed.
 
   /// Prepare the response for the next request.
   ///
@@ -49,40 +49,40 @@ class FakeHttpClient extends http.BaseClient {
   /// will be `body` if non-null, or `jsonEncode(json)` if `json` is non-null,
   /// or else ''.  The `body` and `json` parameters must not both be non-null.
   ///
-  /// If `exception` is non-null, then `httpStatus`, `body`, and `json` must
-  /// all be null, and the next request will throw the given exception.
+  /// If `exception` is non-null, then `httpStatus`, `body`, and `json` must all
+  /// be null, and the next request will throw the given exception.
   void prepare({
     Object? exception,
     int? httpStatus,
     Map<String, dynamic>? json,
     String? body,
     Duration delay = Duration.zero,
   }) {
-    assert(_nextResponse == null,
-      'FakeApiConnection.prepare was called while already expecting a request');
+    // TODO: Prevent a source of bugs by ensuring that there is no outstanding
+    // prepared responses when the test ends.
     if (exception != null) {
       assert(httpStatus == null && json == null && body == null);
-      _nextResponse = _PreparedException(exception: exception, delay: delay);
+      _preparedResponses.addLast(_PreparedException(exception: exception, delay: delay));
     } else {
       assert((json == null) || (body == null));
       final String resolvedBody = switch ((body, json)) {
         (var body?, _) => body,
         (_, var json?) => jsonEncode(json),
         _              => '',
       };
-      _nextResponse = _PreparedSuccess(
+      _preparedResponses.addLast(_PreparedSuccess(
         httpStatus: httpStatus ?? 200,
         bytes: utf8.encode(resolvedBody),
         delay: delay,
-      );
+      ));
     }
   }
 
   @override
   Future<http.StreamedResponse> send(http.BaseRequest request) {
     requestHistory.add(request);
 
-    if (_nextResponse == null) {
+    if (_preparedResponses.isEmpty) {
       throw FlutterError.fromParts([
         ErrorSummary(
           'An API request was attempted in a test when no response was prepared.'),
@@ -91,8 +91,7 @@ class FakeHttpClient extends http.BaseClient {
           'call to [FakeApiConnection.prepare].'),
       ]);
     }
-    final response = _nextResponse!;
-    _nextResponse = null;
+    final response = _preparedResponses.removeFirst();
 
     final http.StreamedResponse Function() computation;
     switch (response) {