feat: implement emulation.setTimezoneOverride (#3589)

Co-authored-by: Browser Automation Bot <[email protected]>

Author: sadym-chromium

src/bidiMapper/BidiNoOpParser.ts

@@ -196,6 +196,11 @@ export class BidiNoOpParser implements BidiCommandParameterParser {
   ): Emulation.SetScreenOrientationOverrideParameters {
     return params as Emulation.SetScreenOrientationOverrideParameters;
   }
+  parseSetTimezoneOverrideParams(
+    params: unknown,
+  ): Emulation.SetTimezoneOverrideParameters {
+    return params as Emulation.SetTimezoneOverrideParameters;
+  }
   // keep-sorted end
 
   // Script module

src/bidiMapper/BidiParser.ts

@@ -128,6 +128,9 @@ export interface BidiCommandParameterParser {
   parseSetScreenOrientationOverrideParams(
     params: unknown,
   ): Emulation.SetScreenOrientationOverrideParameters;
+  parseSetTimezoneOverrideParams(
+    params: unknown,
+  ): Emulation.SetTimezoneOverrideParameters;
   // keep-sorted end
 
   // Input module

src/bidiMapper/CommandProcessor.ts

@@ -326,6 +326,10 @@ export class CommandProcessor extends EventEmitter<CommandProcessorEventsMap> {
         return await this.#emulationProcessor.setScreenOrientationOverride(
           this.#parser.parseSetScreenOrientationOverrideParams(command.params),
         );
+      case 'emulation.setTimezoneOverride':
+        return await this.#emulationProcessor.setTimezoneOverride(
+          this.#parser.parseSetTimezoneOverrideParams(command.params),
+        );
       // keep-sorted end
 
       // Input module

src/bidiMapper/modules/browser/UserContextConfig.ts

@@ -39,6 +39,7 @@ export class UserContextConfig {
     | null;
   locale?: string | null;
   screenOrientation?: Emulation.ScreenOrientation | null;
+  timezone?: string | null;
   userPromptHandler?: Session.UserPromptHandler;
 
   constructor(userContextId: string) {

src/bidiMapper/modules/cdp/CdpTarget.ts

@@ -669,6 +669,10 @@ export class CdpTarget {
       promises.push(this.setLocaleOverride(this.#userContextConfig.locale));
     }
 
+    if (this.#userContextConfig.timezone !== undefined) {
+      promises.push(this.setTimezoneOverride(this.#userContextConfig.timezone));
+    }
+
     if (this.#userContextConfig.acceptInsecureCerts !== undefined) {
       promises.push(
         this.cdpClient.sendCommand('Security.setIgnoreCertificateErrors', {
@@ -833,4 +837,17 @@ export class CdpTarget {
       });
     }
   }
+
+  async setTimezoneOverride(timezone: string | null): Promise<void> {
+    if (timezone === null) {
+      await this.cdpClient.sendCommand('Emulation.setTimezoneOverride', {
+        // If empty, disables the override and restores default host system timezone.
+        timezoneId: '',
+      });
+    } else {
+      await this.cdpClient.sendCommand('Emulation.setTimezoneOverride', {
+        timezoneId: timezone,
+      });
+    }
+  }
 }