remote/doc/Prefs.md

   1 Preferences
   2 ===========
   3
   4 There are a couple of preferences associated with the Remote Agent:
   5
   6
   7 Configurable preferences
   8 ------------------------
   9
  10 ### `remote.active-protocols`
  11
  12 Defines the remote protocols that are active. Available protocols are,
  13 WebDriver BiDi (`1`), and CDP (`2`). Multiple protocols can be activated
  14 at the same time by using bitwise or with the values. Defaults to `3` (WebDriver
  15 BiDi and CDP).
  16
  17 ### `remote.experimental.enabled`
  18
  19 Defines if WebDriver BiDi experimental commands and events are available for usage.
  20 Defaults to `true` in Nightly builds, and `false` otherwise.
  21
  22 ### `remote.log.level`
  23
  24 Defines the verbosity of the internal logger.  Available levels
  25 are, in descending order of severity, `Trace`, `Debug`, `Config`,
  26 `Info`, `Warn`, `Error`, and `Fatal`.  Note that the value is
  27 treated case-sensitively.
  28
  29 ### `remote.log.truncate`
  30
  31 Defines whether long log messages should be truncated. Defaults to true.
  32
  33 ### `remote.prefs.recommended`
  34
  35 By default remote protocols attempts to set a range of preferences deemed
  36 suitable in automation when it starts.  These include the likes of
  37 disabling auto-updates, Telemetry, and first-run UX. Set this preference to
  38 `false` to skip setting those preferences, which is mostly useful for internal
  39 Firefox CI suites.
  40
  41 The user preference file takes precedence over the recommended
  42 preferences, meaning any user-defined preference value will not be
  43 overridden.