@checkly/playwright-core 1.42.18 → 1.47.20-alpha

package/lib/server/codegen/csharp.js

@@ -0,0 +1,299 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CSharpLanguageGenerator = void 0;
+var _language = require("./language");
+var _utils = require("../../utils");
+var _deviceDescriptors = require("../deviceDescriptors");
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+class CSharpLanguageGenerator {
+  constructor(mode) {
+    this.id = void 0;
+    this.groupName = '.NET C#';
+    this.name = void 0;
+    this.highlighter = 'csharp';
+    this._mode = void 0;
+    if (mode === 'library') {
+      this.name = 'Library';
+      this.id = 'csharp';
+    } else if (mode === 'mstest') {
+      this.name = 'MSTest';
+      this.id = 'csharp-mstest';
+    } else if (mode === 'nunit') {
+      this.name = 'NUnit';
+      this.id = 'csharp-nunit';
+    } else {
+      throw new Error(`Unknown C# language mode: ${mode}`);
+    }
+    this._mode = mode;
+  }
+  generateAction(actionInContext) {
+    const action = this._generateActionInner(actionInContext);
+    if (action) return action;
+    return '';
+  }
+  _generateActionInner(actionInContext) {
+    const action = actionInContext.action;
+    if (this._mode !== 'library' && (action.name === 'openPage' || action.name === 'closePage')) return '';
+    let pageAlias = actionInContext.frame.pageAlias;
+    if (this._mode !== 'library') pageAlias = pageAlias.replace('page', 'Page');
+    const formatter = new CSharpFormatter(this._mode === 'library' ? 0 : 8);
+    if (action.name === 'openPage') {
+      formatter.add(`var ${pageAlias} = await context.NewPageAsync();`);
+      if (action.url && action.url !== 'about:blank' && action.url !== 'chrome://newtab/') formatter.add(`await ${pageAlias}.GotoAsync(${quote(action.url)});`);
+      return formatter.format();
+    }
+    const locators = actionInContext.frame.framePath.map(selector => `.${this._asLocator(selector)}.ContentFrame()`);
+    const subject = `${pageAlias}${locators.join('')}`;
+    const signals = (0, _language.toSignalMap)(action);
+    if (signals.dialog) {
+      formatter.add(`    void ${pageAlias}_Dialog${signals.dialog.dialogAlias}_EventHandler(object sender, IDialog dialog)
+      {
+          Console.WriteLine($"Dialog message: {dialog.Message}");
+          dialog.DismissAsync();
+          ${pageAlias}.Dialog -= ${pageAlias}_Dialog${signals.dialog.dialogAlias}_EventHandler;
+      }
+      ${pageAlias}.Dialog += ${pageAlias}_Dialog${signals.dialog.dialogAlias}_EventHandler;`);
+    }
+    const lines = [];
+    lines.push(this._generateActionCall(subject, actionInContext));
+    if (signals.download) {
+      lines.unshift(`var download${signals.download.downloadAlias} = await ${pageAlias}.RunAndWaitForDownloadAsync(async () =>\n{`);
+      lines.push(`});`);
+    }
+    if (signals.popup) {
+      lines.unshift(`var ${signals.popup.popupAlias} = await ${pageAlias}.RunAndWaitForPopupAsync(async () =>\n{`);
+      lines.push(`});`);
+    }
+    for (const line of lines) formatter.add(line);
+    return formatter.format();
+  }
+  _generateActionCall(subject, actionInContext) {
+    const action = actionInContext.action;
+    switch (action.name) {
+      case 'openPage':
+        throw Error('Not reached');
+      case 'closePage':
+        return `await ${subject}.CloseAsync();`;
+      case 'click':
+        {
+          let method = 'Click';
+          if (action.clickCount === 2) method = 'DblClick';
+          const options = (0, _language.toClickOptions)(action);
+          if (!Object.entries(options).length) return `await ${subject}.${this._asLocator(action.selector)}.${method}Async();`;
+          const optionsString = formatObject(options, '    ', 'Locator' + method + 'Options');
+          return `await ${subject}.${this._asLocator(action.selector)}.${method}Async(${optionsString});`;
+        }
+      case 'check':
+        return `await ${subject}.${this._asLocator(action.selector)}.CheckAsync();`;
+      case 'uncheck':
+        return `await ${subject}.${this._asLocator(action.selector)}.UncheckAsync();`;
+      case 'fill':
+        return `await ${subject}.${this._asLocator(action.selector)}.FillAsync(${quote(action.text)});`;
+      case 'setInputFiles':
+        return `await ${subject}.${this._asLocator(action.selector)}.SetInputFilesAsync(${formatObject(action.files)});`;
+      case 'press':
+        {
+          const modifiers = (0, _language.toKeyboardModifiers)(action.modifiers);
+          const shortcut = [...modifiers, action.key].join('+');
+          return `await ${subject}.${this._asLocator(action.selector)}.PressAsync(${quote(shortcut)});`;
+        }
+      case 'navigate':
+        return `await ${subject}.GotoAsync(${quote(action.url)});`;
+      case 'select':
+        return `await ${subject}.${this._asLocator(action.selector)}.SelectOptionAsync(${formatObject(action.options)});`;
+      case 'assertText':
+        return `await Expect(${subject}.${this._asLocator(action.selector)}).${action.substring ? 'ToContainTextAsync' : 'ToHaveTextAsync'}(${quote(action.text)});`;
+      case 'assertChecked':
+        return `await Expect(${subject}.${this._asLocator(action.selector)})${action.checked ? '' : '.Not'}.ToBeCheckedAsync();`;
+      case 'assertVisible':
+        return `await Expect(${subject}.${this._asLocator(action.selector)}).ToBeVisibleAsync();`;
+      case 'assertValue':
+        {
+          const assertion = action.value ? `ToHaveValueAsync(${quote(action.value)})` : `ToBeEmptyAsync()`;
+          return `await Expect(${subject}.${this._asLocator(action.selector)}).${assertion};`;
+        }
+    }
+  }
+  _asLocator(selector) {
+    return (0, _utils.asLocator)('csharp', selector);
+  }
+  generateHeader(options) {
+    if (this._mode === 'library') return this.generateStandaloneHeader(options);
+    return this.generateTestRunnerHeader(options);
+  }
+  generateStandaloneHeader(options) {
+    const formatter = new CSharpFormatter(0);
+    formatter.add(`
+      using Microsoft.Playwright;
+      using System;
+      using System.Threading.Tasks;
+
+      using var playwright = await Playwright.CreateAsync();
+      await using var browser = await playwright.${toPascal(options.browserName)}.LaunchAsync(${formatObject(options.launchOptions, '    ', 'BrowserTypeLaunchOptions')});
+      var context = await browser.NewContextAsync(${formatContextOptions(options.contextOptions, options.deviceName)});`);
+    formatter.newLine();
+    return formatter.format();
+  }
+  generateTestRunnerHeader(options) {
+    const formatter = new CSharpFormatter(0);
+    formatter.add(`
+      using Microsoft.Playwright.${this._mode === 'nunit' ? 'NUnit' : 'MSTest'};
+      using Microsoft.Playwright;
+
+      ${this._mode === 'nunit' ? `[Parallelizable(ParallelScope.Self)]
+      [TestFixture]` : '[TestClass]'}
+      public class Tests : PageTest
+      {`);
+    const formattedContextOptions = formatContextOptions(options.contextOptions, options.deviceName);
+    if (formattedContextOptions) {
+      formatter.add(`public override BrowserNewContextOptions ContextOptions()
+      {
+          return ${formattedContextOptions};
+      }`);
+      formatter.newLine();
+    }
+    formatter.add(`    [${this._mode === 'nunit' ? 'Test' : 'TestMethod'}]
+    public async Task MyTest()
+    {`);
+    return formatter.format();
+  }
+  generateFooter(saveStorage) {
+    const offset = this._mode === 'library' ? '' : '        ';
+    let storageStateLine = saveStorage ? `\n${offset}await context.StorageStateAsync(new BrowserContextStorageStateOptions\n${offset}{\n${offset}    Path = ${quote(saveStorage)}\n${offset}});\n` : '';
+    if (this._mode !== 'library') storageStateLine += `    }\n}\n`;
+    return storageStateLine;
+  }
+}
+exports.CSharpLanguageGenerator = CSharpLanguageGenerator;
+function formatObject(value, indent = '    ', name = '') {
+  if (typeof value === 'string') {
+    if (['permissions', 'colorScheme', 'modifiers', 'button', 'recordHarContent', 'recordHarMode', 'serviceWorkers'].includes(name)) return `${getClassName(name)}.${toPascal(value)}`;
+    return quote(value);
+  }
+  if (Array.isArray(value)) return `new[] { ${value.map(o => formatObject(o, indent, name)).join(', ')} }`;
+  if (typeof value === 'object') {
+    const keys = Object.keys(value).filter(key => value[key] !== undefined).sort();
+    if (!keys.length) return name ? `new ${getClassName(name)}` : '';
+    const tokens = [];
+    for (const key of keys) {
+      const property = getPropertyName(key);
+      tokens.push(`${property} = ${formatObject(value[key], indent, key)},`);
+    }
+    if (name) return `new ${getClassName(name)}\n{\n${indent}${tokens.join(`\n${indent}`)}\n${indent}}`;
+    return `{\n${indent}${tokens.join(`\n${indent}`)}\n${indent}}`;
+  }
+  if (name === 'latitude' || name === 'longitude') return String(value) + 'm';
+  return String(value);
+}
+function getClassName(value) {
+  switch (value) {
+    case 'viewport':
+      return 'ViewportSize';
+    case 'proxy':
+      return 'ProxySettings';
+    case 'permissions':
+      return 'ContextPermission';
+    case 'modifiers':
+      return 'KeyboardModifier';
+    case 'button':
+      return 'MouseButton';
+    case 'recordHarMode':
+      return 'HarMode';
+    case 'recordHarContent':
+      return 'HarContentPolicy';
+    case 'serviceWorkers':
+      return 'ServiceWorkerPolicy';
+    default:
+      return toPascal(value);
+  }
+}
+function getPropertyName(key) {
+  switch (key) {
+    case 'storageState':
+      return 'StorageStatePath';
+    case 'viewport':
+      return 'ViewportSize';
+    default:
+      return toPascal(key);
+  }
+}
+function toPascal(value) {
+  return value[0].toUpperCase() + value.slice(1);
+}
+function convertContextOptions(options) {
+  const result = {
+    ...options
+  };
+  if (options.recordHar) {
+    result['recordHarPath'] = options.recordHar.path;
+    result['recordHarContent'] = options.recordHar.content;
+    result['recordHarMode'] = options.recordHar.mode;
+    result['recordHarOmitContent'] = options.recordHar.omitContent;
+    result['recordHarUrlFilter'] = options.recordHar.urlFilter;
+    delete result.recordHar;
+  }
+  return result;
+}
+function formatContextOptions(options, deviceName) {
+  const device = deviceName && _deviceDescriptors.deviceDescriptors[deviceName];
+  if (!device) {
+    if (!Object.entries(options).length) return '';
+    return formatObject(convertContextOptions(options), '    ', 'BrowserNewContextOptions');
+  }
+  options = (0, _language.sanitizeDeviceOptions)(device, options);
+  if (!Object.entries(options).length) return `playwright.Devices[${quote(deviceName)}]`;
+  return formatObject(convertContextOptions(options), '    ', `BrowserNewContextOptions(playwright.Devices[${quote(deviceName)}])`);
+}
+class CSharpFormatter {
+  constructor(offset = 0) {
+    this._baseIndent = void 0;
+    this._baseOffset = void 0;
+    this._lines = [];
+    this._baseIndent = ' '.repeat(4);
+    this._baseOffset = ' '.repeat(offset);
+  }
+  prepend(text) {
+    this._lines = text.trim().split('\n').map(line => line.trim()).concat(this._lines);
+  }
+  add(text) {
+    this._lines.push(...text.trim().split('\n').map(line => line.trim()));
+  }
+  newLine() {
+    this._lines.push('');
+  }
+  format() {
+    let spaces = '';
+    let previousLine = '';
+    return this._lines.map(line => {
+      if (line === '') return line;
+      if (line.startsWith('}') || line.startsWith(']') || line.includes('});') || line === ');') spaces = spaces.substring(this._baseIndent.length);
+      const extraSpaces = /^(for|while|if).*\(.*\)$/.test(previousLine) ? this._baseIndent : '';
+      previousLine = line;
+      line = spaces + extraSpaces + line;
+      if (line.endsWith('{') || line.endsWith('[') || line.endsWith('(')) spaces += this._baseIndent;
+      if (line.endsWith('));')) spaces = spaces.substring(this._baseIndent.length);
+      return this._baseOffset + line;
+    }).join('\n');
+  }
+}
+function quote(text) {
+  return (0, _utils.escapeWithQuotes)(text, '\"');
+}

package/lib/server/codegen/java.js

@@ -0,0 +1,235 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.JavaLanguageGenerator = void 0;
+var _language = require("./language");
+var _deviceDescriptors = require("../deviceDescriptors");
+var _javascript = require("./javascript");
+var _utils = require("../../utils");
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+class JavaLanguageGenerator {
+  constructor(mode) {
+    this.id = void 0;
+    this.groupName = 'Java';
+    this.name = void 0;
+    this.highlighter = 'java';
+    this._mode = void 0;
+    if (mode === 'library') {
+      this.name = 'Library';
+      this.id = 'java';
+    } else if (mode === 'junit') {
+      this.name = 'JUnit';
+      this.id = 'java-junit';
+    } else {
+      throw new Error(`Unknown Java language mode: ${mode}`);
+    }
+    this._mode = mode;
+  }
+  generateAction(actionInContext) {
+    const action = actionInContext.action;
+    const pageAlias = actionInContext.frame.pageAlias;
+    const offset = this._mode === 'junit' ? 4 : 6;
+    const formatter = new _javascript.JavaScriptFormatter(offset);
+    if (this._mode !== 'library' && (action.name === 'openPage' || action.name === 'closePage')) return '';
+    if (action.name === 'openPage') {
+      formatter.add(`Page ${pageAlias} = context.newPage();`);
+      if (action.url && action.url !== 'about:blank' && action.url !== 'chrome://newtab/') formatter.add(`${pageAlias}.navigate(${quote(action.url)});`);
+      return formatter.format();
+    }
+    const locators = actionInContext.frame.framePath.map(selector => `.${this._asLocator(selector, false)}.contentFrame()`);
+    const subject = `${pageAlias}${locators.join('')}`;
+    const signals = (0, _language.toSignalMap)(action);
+    if (signals.dialog) {
+      formatter.add(`  ${pageAlias}.onceDialog(dialog -> {
+        System.out.println(String.format("Dialog message: %s", dialog.message()));
+        dialog.dismiss();
+      });`);
+    }
+    let code = this._generateActionCall(subject, actionInContext, !!actionInContext.frame.framePath.length);
+    if (signals.popup) {
+      code = `Page ${signals.popup.popupAlias} = ${pageAlias}.waitForPopup(() -> {
+        ${code}
+      });`;
+    }
+    if (signals.download) {
+      code = `Download download${signals.download.downloadAlias} = ${pageAlias}.waitForDownload(() -> {
+        ${code}
+      });`;
+    }
+    formatter.add(code);
+    return formatter.format();
+  }
+  _generateActionCall(subject, actionInContext, inFrameLocator) {
+    const action = actionInContext.action;
+    switch (action.name) {
+      case 'openPage':
+        throw Error('Not reached');
+      case 'closePage':
+        return `${subject}.close();`;
+      case 'click':
+        {
+          let method = 'click';
+          if (action.clickCount === 2) method = 'dblclick';
+          const options = (0, _language.toClickOptions)(action);
+          const optionsText = formatClickOptions(options);
+          return `${subject}.${this._asLocator(action.selector, inFrameLocator)}.${method}(${optionsText});`;
+        }
+      case 'check':
+        return `${subject}.${this._asLocator(action.selector, inFrameLocator)}.check();`;
+      case 'uncheck':
+        return `${subject}.${this._asLocator(action.selector, inFrameLocator)}.uncheck();`;
+      case 'fill':
+        return `${subject}.${this._asLocator(action.selector, inFrameLocator)}.fill(${quote(action.text)});`;
+      case 'setInputFiles':
+        return `${subject}.${this._asLocator(action.selector, inFrameLocator)}.setInputFiles(${formatPath(action.files.length === 1 ? action.files[0] : action.files)});`;
+      case 'press':
+        {
+          const modifiers = (0, _language.toKeyboardModifiers)(action.modifiers);
+          const shortcut = [...modifiers, action.key].join('+');
+          return `${subject}.${this._asLocator(action.selector, inFrameLocator)}.press(${quote(shortcut)});`;
+        }
+      case 'navigate':
+        return `${subject}.navigate(${quote(action.url)});`;
+      case 'select':
+        return `${subject}.${this._asLocator(action.selector, inFrameLocator)}.selectOption(${formatSelectOption(action.options.length > 1 ? action.options : action.options[0])});`;
+      case 'assertText':
+        return `assertThat(${subject}.${this._asLocator(action.selector, inFrameLocator)}).${action.substring ? 'containsText' : 'hasText'}(${quote(action.text)});`;
+      case 'assertChecked':
+        return `assertThat(${subject}.${this._asLocator(action.selector, inFrameLocator)})${action.checked ? '' : '.not()'}.isChecked();`;
+      case 'assertVisible':
+        return `assertThat(${subject}.${this._asLocator(action.selector, inFrameLocator)}).isVisible();`;
+      case 'assertValue':
+        {
+          const assertion = action.value ? `hasValue(${quote(action.value)})` : `isEmpty()`;
+          return `assertThat(${subject}.${this._asLocator(action.selector, inFrameLocator)}).${assertion};`;
+        }
+    }
+  }
+  _asLocator(selector, inFrameLocator) {
+    return (0, _utils.asLocator)('java', selector, inFrameLocator);
+  }
+  generateHeader(options) {
+    const formatter = new _javascript.JavaScriptFormatter();
+    if (this._mode === 'junit') {
+      formatter.add(`
+      import com.microsoft.playwright.junit.UsePlaywright;
+      import com.microsoft.playwright.Page;
+      import com.microsoft.playwright.options.*;
+
+      import org.junit.jupiter.api.*;
+      import static com.microsoft.playwright.assertions.PlaywrightAssertions.*;
+
+      @UsePlaywright
+      public class TestExample {
+        @Test
+        void test(Page page) {`);
+      return formatter.format();
+    }
+    formatter.add(`
+    import com.microsoft.playwright.*;
+    import com.microsoft.playwright.options.*;
+    import static com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat;
+    import java.util.*;
+
+    public class Example {
+      public static void main(String[] args) {
+        try (Playwright playwright = Playwright.create()) {
+          Browser browser = playwright.${options.browserName}().launch(${formatLaunchOptions(options.launchOptions)});
+          BrowserContext context = browser.newContext(${formatContextOptions(options.contextOptions, options.deviceName)});`);
+    return formatter.format();
+  }
+  generateFooter(saveStorage) {
+    const storageStateLine = saveStorage ? `\n      context.storageState(new BrowserContext.StorageStateOptions().setPath(${quote(saveStorage)}));\n` : '';
+    if (this._mode === 'junit') {
+      return `${storageStateLine}  }
+}`;
+    }
+    return `${storageStateLine}    }
+  }
+}`;
+  }
+}
+exports.JavaLanguageGenerator = JavaLanguageGenerator;
+function formatPath(files) {
+  if (Array.isArray(files)) {
+    if (files.length === 0) return 'new Path[0]';
+    return `new Path[] {${files.map(s => 'Paths.get(' + quote(s) + ')').join(', ')}}`;
+  }
+  return `Paths.get(${quote(files)})`;
+}
+function formatSelectOption(options) {
+  if (Array.isArray(options)) {
+    if (options.length === 0) return 'new String[0]';
+    return `new String[] {${options.map(s => quote(s)).join(', ')}}`;
+  }
+  return quote(options);
+}
+function formatLaunchOptions(options) {
+  const lines = [];
+  if (!Object.keys(options).filter(key => options[key] !== undefined).length) return '';
+  lines.push('new BrowserType.LaunchOptions()');
+  if (options.channel) lines.push(`  .setChannel(${quote(options.channel)})`);
+  if (typeof options.headless === 'boolean') lines.push(`  .setHeadless(false)`);
+  return lines.join('\n');
+}
+function formatContextOptions(contextOptions, deviceName) {
+  var _options$recordHar, _options$recordHar2, _options$recordHar3, _options$recordHar4, _options$recordHar5, _options$recordHar6, _options$recordHar7;
+  const lines = [];
+  if (!Object.keys(contextOptions).length && !deviceName) return '';
+  const device = deviceName ? _deviceDescriptors.deviceDescriptors[deviceName] : {};
+  const options = {
+    ...device,
+    ...contextOptions
+  };
+  lines.push('new Browser.NewContextOptions()');
+  if (options.acceptDownloads) lines.push(`  .setAcceptDownloads(true)`);
+  if (options.bypassCSP) lines.push(`  .setBypassCSP(true)`);
+  if (options.colorScheme) lines.push(`  .setColorScheme(ColorScheme.${options.colorScheme.toUpperCase()})`);
+  if (options.deviceScaleFactor) lines.push(`  .setDeviceScaleFactor(${options.deviceScaleFactor})`);
+  if (options.geolocation) lines.push(`  .setGeolocation(${options.geolocation.latitude}, ${options.geolocation.longitude})`);
+  if (options.hasTouch) lines.push(`  .setHasTouch(${options.hasTouch})`);
+  if (options.isMobile) lines.push(`  .setIsMobile(${options.isMobile})`);
+  if (options.locale) lines.push(`  .setLocale(${quote(options.locale)})`);
+  if (options.proxy) lines.push(`  .setProxy(new Proxy(${quote(options.proxy.server)}))`);
+  if ((_options$recordHar = options.recordHar) !== null && _options$recordHar !== void 0 && _options$recordHar.content) lines.push(`  .setRecordHarContent(HarContentPolicy.${(_options$recordHar2 = options.recordHar) === null || _options$recordHar2 === void 0 ? void 0 : _options$recordHar2.content.toUpperCase()})`);
+  if ((_options$recordHar3 = options.recordHar) !== null && _options$recordHar3 !== void 0 && _options$recordHar3.mode) lines.push(`  .setRecordHarMode(HarMode.${(_options$recordHar4 = options.recordHar) === null || _options$recordHar4 === void 0 ? void 0 : _options$recordHar4.mode.toUpperCase()})`);
+  if ((_options$recordHar5 = options.recordHar) !== null && _options$recordHar5 !== void 0 && _options$recordHar5.omitContent) lines.push(`  .setRecordHarOmitContent(true)`);
+  if ((_options$recordHar6 = options.recordHar) !== null && _options$recordHar6 !== void 0 && _options$recordHar6.path) lines.push(`  .setRecordHarPath(Paths.get(${quote(options.recordHar.path)}))`);
+  if ((_options$recordHar7 = options.recordHar) !== null && _options$recordHar7 !== void 0 && _options$recordHar7.urlFilter) lines.push(`  .setRecordHarUrlFilter(${quote(options.recordHar.urlFilter)})`);
+  if (options.serviceWorkers) lines.push(`  .setServiceWorkers(ServiceWorkerPolicy.${options.serviceWorkers.toUpperCase()})`);
+  if (options.storageState) lines.push(`  .setStorageStatePath(Paths.get(${quote(options.storageState)}))`);
+  if (options.timezoneId) lines.push(`  .setTimezoneId(${quote(options.timezoneId)})`);
+  if (options.userAgent) lines.push(`  .setUserAgent(${quote(options.userAgent)})`);
+  if (options.viewport) lines.push(`  .setViewportSize(${options.viewport.width}, ${options.viewport.height})`);
+  return lines.join('\n');
+}
+function formatClickOptions(options) {
+  const lines = [];
+  if (options.button) lines.push(`  .setButton(MouseButton.${options.button.toUpperCase()})`);
+  if (options.modifiers) lines.push(`  .setModifiers(Arrays.asList(${options.modifiers.map(m => `KeyboardModifier.${m.toUpperCase()}`).join(', ')}))`);
+  if (options.clickCount) lines.push(`  .setClickCount(${options.clickCount})`);
+  if (options.position) lines.push(`  .setPosition(${options.position.x}, ${options.position.y})`);
+  if (!lines.length) return '';
+  lines.unshift(`new Locator.ClickOptions()`);
+  return lines.join('\n');
+}
+function quote(text) {
+  return (0, _utils.escapeWithQuotes)(text, '\"');
+}