Skip to main content

Setting browser locale and timezone

Molly Exten
  • Updated

In mabl, you can override the default settings for browser locale and timezone in cloud runs, local runs, and training sessions. Setting a specific browser locale and/or timezone is useful for:

  • Multi-locale testing - Some web apps settings like language, currency, date format, and numbers depending on the browser locale. For example, a web app may display the currency in US Dollars when the locale is en-US and in British pounds if the locale is en-GB. Or if you are testing a restaurant delivery application in Japan, you can set the locale to ja and the timezone to UTC+9 so that prices and delivery times are consistent during training and execution.
  • Reducing discrepancies in test behavior during training and execution - If a test passes locally but fails in the cloud and the difference involves dates, times, currency, or language, the issue may be a timezone mismatch between training and execution environments. By default, cloud runs default to en-US and UTC+0, while trainer and local runs use your machine’s settings. Setting the browser locale and timezone can address this discrepancy.

What is browser locale?

Browser locales are a combination of language and regional identifiers that can affect the language used by webpages and the displayed values for currencies, date formats, and numbers. You may also know this as the browser language settings.

Cloud runs

Plan runs

Locale and timezone settings configured on a plan apply to every test and every DataTable scenario in that plan run. To edit the browser locale and timezone for a specific plan, take the following steps:

  1. Click on the pencil icon on the plan details page
  2. In the Browser device settings section, click on Additional settings
  3. Select the desired browser locale and/or timezone from the dropdowns.
  4. Save your plan.

Setting browser locale and timezone for plan runs

Setting browser locale and timezone for plan runs

Ad hoc runs

To edit the browser locale and timezone for ad hoc cloud runs, take the following steps:

  1. On the test details page, click on the Run test button.
  2. On the Cloud run tab, toggle on “Customize localization options”
  3. Select the desired browser locale and/or timezone from the dropdowns.
  4. Click on the Start run button.

Setting browser locale and timezone for ad hoc cloud runs

Setting browser locale and timezone for ad hoc cloud runs

Local runs and training sessions

To set the browser locale and/or timezone for local runs and training sessions in the mabl Trainer, use the preferences menu:

  1. Go to Edit > Preferences in the menu bar.
  2. Click on the Browser tab.
  3. Select the desired browser locale and/or timezone from the dropdowns.
  4. Save your settings.

Editing locale and time zone settings in the Desktop App

Editing locale and time zone settings in the Desktop App

Test runs initiated via the CLI

To set the browser locale and/or timezone for tests initiated using the mabl CLI, use the --locale or --timezone-id flags:

mabl tests run-cloud --locale ja-JP --timezone-id Asia/Tokyo

If you trigger a plan run with --from-plan-id, locale and timezone configured on the plan in the UI do not apply. --from-plan-id runs execute locally. Pass --locale and --timezone-id directly on the CLI command.

mabl tests run --from-plan-id [plan-id] --locale ja-JP --timezone-id Asia/Tokyo

Related articles