Browser configuration - Momentic

Documentation Index

Fetch the complete documentation index at: /docs/llms.txt

Use this file to discover all available pages before exploring further.

These defaults apply to every browser-based test in the project. Individual tests can override any of these values.

momentic.config.yaml

browser:
  defaultBrowserType: Chromium
  smartWaitingTimeoutMs: 5000
  pageLoadTimeoutMs: 8000
  slowMoMs: 250

Identity

browser.defaultBrowserType

"Chromium" | "Google Chrome" | "Chrome for Testing"

Default browser used by all tests in the project.

momentic.config.yaml

browser:
  defaultBrowserType: Chromium

• Chromium: lightweight, open-source browser with a basic feature set. The same engine Playwright and Cypress use.
• Google Chrome: full Google Chrome build with PDF rendering and WebGL.
• Chrome for Testing: a versioned Chrome build for test automation, without auto-update.

browser.userAgent

string | null

User agent string sent on every request. Defaults to the current Chrome desktop UA. Set to null to disable the default override and use the browser’s native user agent (which then matches the runner’s OS).

momentic.config.yaml

browser:
  userAgent:
    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML,
    like Gecko) Chrome/138.0.0.0 Safari/537.36"

momentic.config.yaml

browser:
  userAgent: null # use the browser's native user agent

browser.timezone

string

Default IANA timezone. Defaults to America/Los_Angeles. Per-test settings override this.

momentic.config.yaml

browser:
  timezone: America/New_York

browser.useHostTimezone

boolean

Use the host machine’s timezone instead. When true, all timezone settings (project- and test-level) are ignored. Default: false.

momentic.config.yaml

browser:
  useHostTimezone: true

Timeouts

browser.pageLoadTimeoutMs

number

Maximum wait time for a page to load, in milliseconds. Applies to new tabs and navigation events. Default: 8000.

momentic.config.yaml

browser:
  pageLoadTimeoutMs: 20000

browser.ignorePageLoadTimeouts

boolean

Continue after page-load timeouts instead of failing the test. Default: false.

momentic.config.yaml

browser:
  ignorePageLoadTimeouts: true

browser.smartWaitingTimeoutMs

number

Maximum wait time for smart waiting between steps, in milliseconds. Default: 5000.

momentic.config.yaml

browser:
  smartWaitingTimeoutMs: 10000

browser.elementCheckTimeoutSeconds

number

Default maximum wait time for element check assertions to become true, in seconds. Default: 5.

momentic.config.yaml

browser:
  elementCheckTimeoutSeconds: 10

browser.typeDelayMs

number

Default delay between keystrokes for type steps, in milliseconds. Default: 25.

momentic.config.yaml

browser:
  typeDelayMs: 60

browser.pressDelayMs

number

How long each key stays held between keydown and keyup for press steps, in milliseconds. Default: 0.

momentic.config.yaml

browser:
  pressDelayMs: 60

Execution timing

browser.slowMoMs

number

Wait between steps in a step list, in milliseconds. Default: 0.

momentic.config.yaml

browser:
  slowMoMs: 250

Headers, storage, and permissions

browser.extraHeaders

Record<string, string>

Set browser.extraHeaders to add HTTP headers to browser requests. Headers apply to every requested host, including third-party hosts. Load credentials from environment variables instead of writing tokens into your config:

momentic.config.yaml

name: browser-header-tests
browser:
  extraHeaders:
    Authorization: "Bearer {{ env.AUTH_TOKEN }}"
    X-Test-Run: momentic
environments:
  - name: staging
    baseUrl: https://staging.example.com
    inheritFromShell: true

browser.initialLocalStorage

Record<origin, Record<key, value>>

Local storage values to seed per origin before the test starts.

momentic.config.yaml

browser:
  initialLocalStorage:
    https://momentic.ai:
      momenticTestKey1: momenticTestValue1
      momenticTestKey2: momenticTestValue2

browser.localChromeExtensionPaths

string[]

Paths to unpacked Chrome extension directories. Each directory must contain manifest.json.

momentic.config.yaml

browser:
  defaultBrowserType: Chromium
  remoteBrowser: false
  localChromeExtensionPaths:
    - ./extensions/checkout-helper

browser.grantedPermissions

string[]

Browser permissions to auto-grant during the run. When omitted, all permissions are granted.

momentic.config.yaml

browser:
  grantedPermissions:
    - clipboard-read
    - clipboard-write
    - microphone
    - camera
    - geolocation

browser.ignoreHttpsErrors

boolean

Ignore HTTPS errors like self-signed certificates. Useful for internal or development environments. Default: false.

momentic.config.yaml

browser:
  ignoreHttpsErrors: true

Performance and stability

browser.remoteBrowser

boolean

Run tests on Momentic hosted browsers instead of a local Chromium. Applies to momentic run only. Default: false.

momentic.config.yaml

browser:
  remoteBrowser: true

browser.disableGpu

boolean

Disable intensive graphical operations (WebGL, hardware-accelerated raster). Speeds up runs on machines without a dedicated GPU. Default: false.

momentic.config.yaml

browser:
  disableGpu: true

browser.disableZygote

boolean

Disable Chrome’s zygote process. Can reduce process overhead but may break features that depend on the zygote. Default: false. Note: FullStory scripts may also be blocked during the run.