Source code
Revision control
Copy as Markdown
Other Tools
# Preferences
There are a couple of preferences associated with the Remote Agent:
## Configurable preferences
### `remote.active-protocols`
Defines the remote protocols that are active. Available protocols are,
WebDriver BiDi (`1`), and CDP (`2`). Multiple protocols can be activated
at the same time by using bitwise or with the values, such as `3` for
both protocols. Defaults to `1` (WebDriver BiDi) since Firefox 129.
### `remote.events.async.enabled` (experimental)
This preference determines whether asynchronous event dispatching is used to
simulate real user input. By default, it is set to `false`, meaning events are
synthesized directly in the web page's content process, bypassing OS-level
layers like APZ (asynchronous panning and zooming).
Warning: This feature is still under development and should only be enabled for
testing purposes, not in production environments.
### `remote.experimental.enabled`
Defines if WebDriver BiDi experimental commands and events are available for usage.
Defaults to `true` in Nightly builds, and `false` otherwise.
### `remote.log.level`
Defines the verbosity of the internal logger. Available levels
are, in descending order of severity, `Trace`, `Debug`, `Config`,
`Info`, `Warn`, `Error`, and `Fatal`. Note that the value is
treated case-sensitively.
### `remote.log.truncate`
Defines whether long log messages should be truncated. Defaults to true.
### `remote.prefs.recommended`
By default remote protocols attempts to set a range of preferences deemed
suitable in automation when it starts. These include the likes of
disabling auto-updates, Telemetry, and first-run UX. Set this preference to
`false` to skip setting those preferences, which is mostly useful for internal
Firefox CI suites.
The user preference file takes precedence over the recommended
preferences, meaning any user-defined preference value will not be
overridden.
### `remote.retry-on-abort`
This preference defines whether certain IPC calls from the parent process to
content processes should be retried when a browsing context is replaced due
to cross-origin navigation, or made inactive when a page moved into BFCache.
Introduced in Firefox 132, the preference is set to `true` by default.