Added caching options for http package

Author: seifibrahim32

pkgs/http/lib/src/base_request.dart

@@ -165,4 +165,9 @@ abstract class BaseRequest {
 
   @override
   String toString() => '$method $url';
-}
+
+  /// [cache] property for caching the network request.
+  ///
+  /// Defaults to `default`.
+  String? get cache => HttpCacheUtils.defaultType;
+}

pkgs/http/lib/src/browser_client.dart

@@ -69,6 +69,7 @@ class BrowserClient extends BaseClient {
             RequestInit(
               method: request.method,
               body: bodyBytes.isNotEmpty ? bodyBytes.toJS : null,
+              cache: request.cache!,
               credentials: withCredentials ? 'include' : 'same-origin',
               headers: {
                 if (request.contentLength case final contentLength?)

pkgs/http/lib/src/multipart_request.dart

@@ -159,4 +159,17 @@ class MultipartRequest extends BaseRequest {
         growable: false);
     return '$prefix${String.fromCharCodes(list)}';
   }
-}
+
+  @override
+  String? get cache {
+    if(this._cache != null){
+      return this._cache;
+    }
+    else return super.cache;
+  }
+
+  String? _cache;
+  set cache(String? cacheType){
+    this._cache = cacheType!;
+  }
+}

pkgs/http/lib/src/request.dart

@@ -181,4 +181,17 @@ class Request extends BaseRequest {
     if (!finalized) return;
     throw StateError("Can't modify a finalized Request.");
   }
+
+  @override
+  String? get cache {
+    if(this._cache != null){
+      return this._cache;
+    }
+    else return super.cache;
+  }
+
+  String? _cache;
+  set cache(String? cacheType){
+    this._cache = cacheType!;
+  }
 }

pkgs/http/lib/src/streamed_request.dart

@@ -52,4 +52,17 @@ class StreamedRequest extends BaseRequest {
     super.finalize();
     return ByteStream(_controller.stream);
   }
+
+  @override
+  String? get cache {
+    if(this._cache != null){
+      return this._cache;
+    }
+    else return super.cache;
+  }
+
+  String? _cache;
+  set cache(String? cacheType){
+    this._cache = cacheType!;
+  }
 }

pkgs/http/lib/src/utils.dart

@@ -68,3 +68,15 @@ Stream<T> onDone<T>(Stream<T> stream, void Function() onDone) =>
       sink.close();
       onDone();
     }));
+
+/// Caching utilities types for using cache for any http request.
+///
+/// For more references, check (Caching types)[https://developer.mozilla.org/en-US/docs/Web/API/Request/cache]
+mixin HttpCacheUtils{
+  static const String defaultType = "default";
+  static const String reloadType = "reload";
+  static const String noStoringType = "no-store";
+  static const String noCachingType = "no-cache";
+  static const String forceCachingType = "force-cache";
+  static const String onlyIfCachedType = "only-if-cached";
+}