2023-11-24 10:17:08 +00:00
|
|
|
# Preferences
|
2019-01-29 15:18:42 +00:00
|
|
|
|
2021-05-25 09:13:29 +00:00
|
|
|
There are a couple of preferences associated with the Remote Agent:
|
2019-01-29 15:18:42 +00:00
|
|
|
|
2023-11-24 10:17:08 +00:00
|
|
|
## Configurable preferences
|
2019-01-29 15:18:42 +00:00
|
|
|
|
2021-06-01 19:41:01 +00:00
|
|
|
### `remote.active-protocols`
|
|
|
|
|
|
|
|
|
|
Defines the remote protocols that are active. Available protocols are,
|
|
|
|
|
WebDriver BiDi (`1`), and CDP (`2`). Multiple protocols can be activated
|
2024-06-12 08:57:38 +00:00
|
|
|
at the same time by using bitwise or with the values, such as `3` for
|
2024-09-30 20:36:57 +00:00
|
|
|
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.
|
2021-06-01 19:41:01 +00:00
|
|
|
|
2022-07-12 15:55:37 +00:00
|
|
|
### `remote.experimental.enabled`
|
|
|
|
|
|
|
|
|
|
Defines if WebDriver BiDi experimental commands and events are available for usage.
|
|
|
|
|
Defaults to `true` in Nightly builds, and `false` otherwise.
|
|
|
|
|
|
2019-01-29 15:18:42 +00:00
|
|
|
### `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.
|
2020-09-22 15:46:35 +00:00
|
|
|
|
|
|
|
|
### `remote.log.truncate`
|
|
|
|
|
|
|
|
|
|
Defines whether long log messages should be truncated. Defaults to true.
|
2021-07-09 08:42:47 +00:00
|
|
|
|
|
|
|
|
### `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.
|
2024-09-26 16:27:27 +00:00
|
|
|
|
|
|
|
|
### `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.
|
