gecko-dev/remote/doc/Prefs.md

2.2 KiB

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.