Added cache control for http request within BrowserClient

pkgs/http/lib/browser_client.dart

@@ -2,4 +2,4 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-export 'src/browser_client.dart' show BrowserClient;
+export 'src/browser_client.dart' show BrowserClient, CacheMode;

pkgs/http/lib/src/browser_client.dart

@@ -4,7 +4,6 @@
 
 import 'dart:async';
 import 'dart:js_interop';
-
 import 'package:web/web.dart'
     show
         AbortController,
@@ -30,6 +29,23 @@ BaseClient createClient() {
   return BrowserClient();
 }
 
+/// Caching mode used by the [BrowserClient].
+///
+/// Sets the request cache value of the browser Fetch API.
+/// [`Request.cache`](https://developer.mozilla.org/en-US/docs/Web/API/Request/cache) property.
+enum CacheMode {
+  defaultType('default'),
+  reload('reload'),
+  noStore('no-store'),
+  noCache('no-cache'),
+  forceCache('force-cache'),
+  onlyIfCached('only-if-cached');
+
+  final String cacheType;
+
+  const CacheMode(this.cacheType);
+}
+
 /// A `package:web`-based HTTP client that runs in the browser and is backed by
 /// [`window.fetch`](https://fetch.spec.whatwg.org/).
 ///
@@ -45,6 +61,20 @@ BaseClient createClient() {
 class BrowserClient extends BaseClient {
   final _abortController = AbortController();
 
+  final CacheMode _cacheMode;
+
+  /// Create a new browser-based HTTP Client.
+  ///
+  /// If [cacheMode] is provided then it can be used to cache the request
+  /// in the browser.
+  ///
+  /// For example:
+  /// ```dart
+  /// final client = BrowserClient(cacheMode: CacheMode.reload);
+  /// ```
+  BrowserClient({CacheMode cacheMode = CacheMode.defaultType})
+      : _cacheMode = cacheMode;
+
   /// Whether to send credentials such as cookies or authorization headers for
   /// cross-site requests.
   ///
@@ -69,6 +99,7 @@ class BrowserClient extends BaseClient {
             RequestInit(
               method: request.method,
               body: bodyBytes.isNotEmpty ? bodyBytes.toJS : null,
+              cache: _cacheMode.cacheType,
               credentials: withCredentials ? 'include' : 'same-origin',
               headers: {
                 if (request.contentLength case final contentLength?)

pkgs/http/test/html/cache_test.dart

@@ -0,0 +1,83 @@
+// Copyright (c) 2014, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+@TestOn('browser')
+library;
+
+import 'dart:async';
+
+import 'package:http/browser_client.dart';
+import 'package:http/http.dart' as http;
+import 'package:http/src/exception.dart';
+import 'package:test/test.dart';
+
+import 'utils.dart';
+
+void main() {
+  test('#send a StreamedRequest with default type', () async {
+    var client = BrowserClient(cacheMode: CacheMode.defaultType);
+    var request = http.StreamedRequest('POST', echoUrl);
+    var responseFuture = client.send(request);
+    request.sink.add('{"hello": "world"}'.codeUnits);
+    unawaited(request.sink.close());
+
+    var response = await responseFuture;
+
+    client.close();
+
+    expect(response.statusCode, 200);
+    expect(response.reasonPhrase, 'OK');
+  }, skip: 'Need to fix server tests for browser');
+
+  test('#send a StreamedRequest with reload type', () async {
+    var client = BrowserClient(cacheMode: CacheMode.reload);
+    var request = http.StreamedRequest('POST', echoUrl);
+
+    var responseFuture = client.send(request);
+    request.sink.add('{"hello": "world"}'.codeUnits);
+    unawaited(request.sink.close());
+    var response = await responseFuture;
+    var bytesString = await response.stream.bytesToString();
+
+    client.close();
+
+    expect(bytesString, contains('no-cache'));
+  }, skip: 'Need to fix server tests for browser');
+
+  test('#send a StreamedRequest with no-cache type', () async {
+    var client = BrowserClient(cacheMode: CacheMode.noCache);
+    var request = http.StreamedRequest('POST', echoUrl);
+
+    var responseFuture = client.send(request);
+    request.sink.add('{"hello": "world"}'.codeUnits);
+    unawaited(request.sink.close());
+    var response = await responseFuture;
+    var bytesString = await response.stream.bytesToString();
+
+    client.close();
+    expect(bytesString, contains('max-age=0'));
+  }, skip: 'Need to fix server tests for browser');
+
+  test('#send a StreamedRequest with only-if-cached type', () {
+    var client = BrowserClient(cacheMode: CacheMode.onlyIfCached);
+    var request = http.StreamedRequest('POST', echoUrl);
+
+    expectLater(client.send(request), throwsA(isA<ClientException>()));
+    request.sink.add('{"hello": "world"}'.codeUnits);
+    unawaited(request.sink.close());
+
+    client.close();
+  }, skip: 'Need to fix server tests for browser');
+
+  test('#send with an invalid URL', () {
+    var client = BrowserClient(cacheMode: CacheMode.onlyIfCached);
+    var url = Uri.http('http.invalid', '');
+    var request = http.StreamedRequest('POST', url);
+
+    expect(client.send(request), throwsClientException());
+
+    request.sink.add('{"hello": "world"}'.codeUnits);
+    request.sink.close();
+  }, skip: 'Need to fix server tests for browser');
+}