feat: support network.setCacheBehavior (#2593)

Closes #2385

---------

Co-authored-by: browser-automation-bot <133232582+browser-automation-bot@users.noreply.github.com>

eslint.config.mjs

@@ -126,7 +126,6 @@ export default [
       'mocha/no-exclusive-tests': 'error',
       'mocha/no-mocha-arrows': 'off',
       'mocha/no-setup-in-describe': 'off',
-      'no-console': 'warn',
       'no-else-return': 'warn',
 
       'no-empty': [
@@ -181,6 +180,8 @@ export default [
     },
 
     rules: {
+      'no-console': 'warn',
+
       'no-restricted-syntax': [
         'error',
         {

src/bidiMapper/modules/cdp/CdpTarget.ts

@@ -48,6 +48,7 @@ export class CdpTarget {
   readonly #unhandledPromptBehavior?: Session.UserPromptHandler;
   readonly #logger: LoggerFn | undefined;
 
+  #cacheDisableState = false;
   #networkDomainEnabled = false;
   #fetchDomainStages = {
     request: false,
@@ -279,9 +280,9 @@ export class CdpTarget {
     this.#networkDomainEnabled = enabled;
     try {
       await Promise.all([
-        this.#cdpClient.sendCommand(
-          enabled ? 'Network.enable' : 'Network.disable'
-        ),
+        this.#cdpClient
+          .sendCommand(enabled ? 'Network.enable' : 'Network.disable')
+          .then(async () => await this.toggleSetCacheDisabled()),
         this.toggleFetchIfNeeded(),
       ]);
     } catch (err) {
@@ -290,6 +291,23 @@ export class CdpTarget {
     }
   }
 
+  async toggleSetCacheDisabled(disable?: boolean) {
+    const defaultCacheDisabled =
+      this.#networkStorage.defaultCacheBehavior === 'bypass';
+    const cacheDisabled = disable ?? defaultCacheDisabled;
+
+    if (
+      !this.#networkDomainEnabled ||
+      this.#cacheDisableState === cacheDisabled
+    ) {
+      return;
+    }
+    this.#cacheDisableState = cacheDisabled;
+    await this.#cdpClient.sendCommand('Network.setCacheDisabled', {
+      cacheDisabled,
+    });
+  }
+
   async toggleDeviceAccessIfNeeded(): Promise<void> {
     const enabled = this.isSubscribedTo(BiDiModule.Bluetooth);
     await this.#cdpClient.sendCommand(

src/bidiMapper/modules/network/NetworkProcessor.ts

@@ -20,7 +20,6 @@ import {
   type EmptyResult,
   NoSuchRequestException,
   InvalidArgumentException,
-  UnknownErrorException,
 } from '../../../protocol/protocol.js';
 import {URLPattern} from '../../../utils/UrlPattern.js';
 import type {BrowsingContextStorage} from '../context/BrowsingContextStorage.js';
@@ -189,13 +188,35 @@ export class NetworkProcessor {
     return {};
   }
 
-  // eslint-disable-next-line @typescript-eslint/require-await
   async setCacheBehavior(
-    _params: Network.SetCacheBehaviorParameters
+    params: Network.SetCacheBehaviorParameters
   ): Promise<EmptyResult> {
-    throw new UnknownErrorException(
-      "Method 'network.setCacheBehavior' is not implemented."
+    const contexts = this.#browsingContextStorage.verifyTopLevelContextsList(
+      params.contexts
     );
+
+    // Change all targets
+    if (contexts.size === 0) {
+      this.#networkStorage.defaultCacheBehavior = params.cacheBehavior;
+
+      await Promise.all(
+        this.#browsingContextStorage.getAllContexts().map((context) => {
+          return context.cdpTarget.toggleSetCacheDisabled();
+        })
+      );
+
+      return {};
+    }
+
+    const cacheDisabled = params.cacheBehavior === 'bypass';
+
+    await Promise.all(
+      [...contexts.values()].map((context) => {
+        return context.cdpTarget.toggleSetCacheDisabled(cacheDisabled);
+      })
+    );
+
+    return {};
   }
 
   #getRequestOrFail(id: Network.Request): NetworkRequest {

src/bidiMapper/modules/network/NetworkStorage.ts

@@ -53,6 +53,9 @@ export class NetworkStorage {
   /** A map from intercept ID to track active network intercepts. */
   readonly #intercepts = new Map<Network.Intercept, NetworkInterception>();
 
+  #defaultCacheBehavior: Network.SetCacheBehaviorParameters['cacheBehavior'] =
+    'default';
+
   constructor(
     eventManager: EventManager,
     browsingContextStorage: BrowsingContextStorage,
@@ -328,4 +331,14 @@ export class NetworkStorage {
       this.#browsingContextStorage.findContext(contextId)?.navigationId ?? null
     );
   }
+
+  set defaultCacheBehavior(
+    behavior: Network.SetCacheBehaviorParameters['cacheBehavior']
+  ) {
+    this.#defaultCacheBehavior = behavior;
+  }
+
+  get defaultCacheBehavior() {
+    return this.#defaultCacheBehavior;
+  }
 }