# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/. */
# This file defines static prefs, i.e. those that are defined at startup and
# used entirely or mostly from C++ and/or Rust code.
#
# The file is separated into sections, where each section contains a group of
# prefs that all share the same first segment of their name -- all the "gfx.*"
# prefs are together, all the "network.*" prefs are together, etc. Sections
# must be kept in alphabetical order, but prefs within sections need not be.
#
# Basics
# ------
# Any pref defined in one of the files included here should *not* be defined
# in a data file such as all.js; that would just be useless duplication.
#
# (Except under unusual circumstances where the value defined here must be
# overridden, e.g. for some Thunderbird prefs. In those cases the default
# value from the data file will override the static default value defined
# here.)
#
# Please follow the existing prefs naming convention when considering adding a
# new pref, and don't create a new pref group unless it's appropriate and there
# are likely to be multiple prefs within that group. (If you do, you'll need to
# update the `pref_groups` variable in modules/libpref/moz.build.)
#
# Definitions
# -----------
# A pref definition looks like this:
#
# - name: <pref-name> # mandatory
# type: <cpp-type> # mandatory
# value: <default-value> # mandatory
# mirror: <never | once | always> # mandatory
# do_not_use_directly: <true | false> # optional
# include: <header-file> # optional
# rust: <true | false> # optional
#
# - `name` is the name of the pref, without double-quotes, as it appears
# in about:config. It is used in most libpref API functions (from both C++
# and JS code).
#
# - `type` is one of `bool`, `int32_t`, `uint32_t`, `float`, an atomic version
# of one of those, or `String`. Note that float prefs are stored internally
# as strings. The C++ preprocessor doesn't like template syntax in a macro
# argument, so use the typedefs defined in StaticPrefsBase.h; for example,
# use `RelaxedAtomicBool` instead of `Atomic<bool, Relaxed>`.
#
# - `value` is the default value. Its type should be appropriate for
# <cpp-type>, otherwise the generated code will fail to compile. A complex
# C++ numeric expressions like `60 * 60` (which the YAML parser cannot treat
# as an integer or float) is treated as a string and passed through without
# change, which is useful.
#
# - `mirror` indicates how the pref value is mirrored into a C++ variable.
#
# * `never`: There is no C++ mirror variable. The pref value can only be
# accessed via the standard libpref API functions.
#
# * `once`: The pref value is mirrored into a variable at startup; the
# mirror variable is left unchanged after that. (The exact point at which
# all `once` mirror variables are set is when the first `once` mirror
# variable is accessed, via its getter function.) This is mostly useful for
# graphics prefs where we often don't want a new pref value to apply until
# restart. Otherwise, this update policy is best avoided because its
# behaviour can cause confusion and bugs.
#
# * `always`: The mirror variable is always kept in sync with the pref value.
# This is the most common choice.
#
# When a mirror variable is present, a getter will be created that can access
# it. Using the getter function to read the pref's value has the two
# following advantages over the normal API functions.
#
# * A direct variable access is faster than a hash table lookup.
#
# * A mirror variable can be accessed off the main thread. If a pref *is*
# accessed off the main thread, it should have an atomic type. Assertions
# enforce this.
#
# Note that Rust code must access the mirror variable directly, rather than
# via the getter function.
#
# - `do_not_use_directly` indicates if `_DoNotUseDirectly` should be appended to
# the name of the getter function. This is simply a naming convention
# indicating that there is some other wrapper getter function that should be
# used in preference to the normal static pref getter. Defaults to `false` if
# not present. Cannot be used with a `never` mirror value, because there is
# no getter function in that case.
#
# - `include` names a header file that must be included for the pref value to
# compile correctly, e.g. because it refers to a code constant. System
# headers should be surrounded with angle brackets, e.g. `<cmath>`.
#
# - `rust` indicates if the mirror variable is used by Rust code. If so, it
# will be usable via the `static_prefs::pref!` macro, e.g.
# `static_prefs::pref!("layout.css.font-display.enabled")`.
#
# The getter function's base name is the same as the pref's name, but with
# '.' or '-' chars converted to '_', to make a valid identifier. For example,
# the getter for `foo.bar_baz` is `foo_bar_baz()`. This is ugly but clear,
# and you can search for both the pref name and the getter using the regexp
# /foo.bar.baz/. Suffixes are added as follows:
#
# - If the `mirror` value is `once`, `_AtStartup` is appended, to indicate the
# value was obtained at startup.
#
# - If the `do_not_use_directly` value is true, `_DoNotUseDirectly` is
# appended.
#
# Preprocessor
# ------------
# Note finally that this file is preprocessed by preprocessor.py, not the C++
# preprocessor. As a result, the following things may be surprising.
#
# - YAML comments start with a '#', so putting a comment on the same line as a
# preprocessor directive is dubious. E.g. avoid lines like `#define X 3 #
# three` because the ` # three` will be part of `X`.
#
# - '@' use is required for substitutions to occur. E.g. with `#define FOO 1`,
# `FOO` won't be replaced with `1` unless it has '@' chars around it.
#
# - Spaces aren't permitted between the leading '#' and the name of a
# directive, e.g. `#ifdef XYZ` works but `# ifdef XYZ` does not.
#
# Please indent all prefs defined within #ifdef/#ifndef conditions. This
# improves readability, particular for conditional blocks that exceed a single
# screen. But note that the leading '-' in a definition must remain in the
# first column for it to be valid YAML.
#ifdef RELEASE_OR_BETA
#define IS_NOT_RELEASE_OR_BETA false
#else
#define IS_NOT_RELEASE_OR_BETA true
#endif
#ifdef NIGHTLY_BUILD
#define IS_NIGHTLY_BUILD true
#define IS_NOT_NIGHTLY_BUILD false
#else
#define IS_NIGHTLY_BUILD false
#define IS_NOT_NIGHTLY_BUILD true
#endif
#ifdef MOZILLA_OFFICIAL
#define IS_NOT_MOZILLA_OFFICIAL false
#else
#define IS_NOT_MOZILLA_OFFICIAL true
#endif
#ifdef EARLY_BETA_OR_EARLIER
#define IS_EARLY_BETA_OR_EARLIER true
#else
#define IS_EARLY_BETA_OR_EARLIER false
#endif
#ifdef ANDROID
#define IS_ANDROID true
#define IS_NOT_ANDROID false
#else
#define IS_ANDROID false
#define IS_NOT_ANDROID true
#endif
#---------------------------------------------------------------------------
# Prefs starting with "accessibility."
#---------------------------------------------------------------------------
- name: accessibility.monoaudio.enable
type: RelaxedAtomicBool
value: false
mirror: always
- name: accessibility.browsewithcaret
type: RelaxedAtomicBool
value: false
mirror: always
- name: accessibility.AOM.enabled
type: bool
value: false
mirror: always
#ifdef ANDROID
#---------------------------------------------------------------------------
# Prefs starting with "android."
#---------------------------------------------------------------------------
# On Android, we want an opaque background to be visible under the page,
# so layout should not force a default background.
- name: android.widget_paints_background
type: bool
value: true
mirror: always
#endif
#---------------------------------------------------------------------------
# Prefs starting with "apz."
# The apz prefs are explained in AsyncPanZoomController.cpp
#---------------------------------------------------------------------------
- name: apz.allow_double_tap_zooming
type: RelaxedAtomicBool
value: true
mirror: always
- name: apz.allow_immediate_handoff
type: RelaxedAtomicBool
value: false
mirror: always
- name: apz.allow_zooming
type: RelaxedAtomicBool
value: @IS_ANDROID@
mirror: always
- name: apz.android.chrome_fling_physics.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: apz.android.chrome_fling_physics.friction
type: AtomicFloat
value: 0.015f
mirror: always
- name: apz.android.chrome_fling_physics.inflexion
type: AtomicFloat
value: 0.35f
mirror: always
- name: apz.android.chrome_fling_physics.stop_threshold
type: AtomicFloat
value: 0.1f
mirror: always
- name: apz.autoscroll.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: apz.axis_lock.breakout_angle
type: AtomicFloat
value: float(M_PI / 8.0) # 22.5 degrees
mirror: always
include: <cmath>
- name: apz.axis_lock.breakout_threshold
type: AtomicFloat
value: 1.0f / 32.0f
mirror: always
- name: apz.axis_lock.direct_pan_angle
type: AtomicFloat
value: float(M_PI / 3.0) # 60 degrees
mirror: always
include: <cmath>
- name: apz.axis_lock.lock_angle
type: AtomicFloat
value: float(M_PI / 6.0) # 30 degrees
mirror: always
include: <cmath>
# Whether to lock touch scrolling to one axis at a time.
# 0 = FREE (No locking at all)
# 1 = STANDARD (Once locked, remain locked until scrolling ends)
# 2 = STICKY (Allow lock to be broken, with hysteresis)
- name: apz.axis_lock.mode
type: RelaxedAtomicInt32
value: 0
mirror: always
- name: apz.content_response_timeout
type: RelaxedAtomicInt32
value: 400
mirror: always
- name: apz.danger_zone_x
type: RelaxedAtomicInt32
value: 50
mirror: always
- name: apz.danger_zone_y
type: RelaxedAtomicInt32
value: 100
mirror: always
- name: apz.disable_for_scroll_linked_effects
type: RelaxedAtomicBool
value: false
mirror: always
- name: apz.displayport_expiry_ms
type: RelaxedAtomicUint32
value: 15000
mirror: always
- name: apz.drag.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: apz.drag.initial.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: apz.drag.touch.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: apz.enlarge_displayport_when_clipped
type: RelaxedAtomicBool
value: @IS_ANDROID@
mirror: always
# Test only.
- name: apz.fixed-margin-override.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# Test only.
- name: apz.fixed-margin-override.bottom
type: RelaxedAtomicInt32
value: 0
mirror: always
# Test only.
- name: apz.fixed-margin-override.top
type: RelaxedAtomicInt32
value: 0
mirror: always
- name: apz.fling_accel_base_mult
type: AtomicFloat
value: 1.0f
mirror: always
- name: apz.fling_accel_interval_ms
type: RelaxedAtomicInt32
value: 500
mirror: always
- name: apz.fling_accel_supplemental_mult
type: AtomicFloat
value: 1.0f
mirror: always
- name: apz.fling_accel_min_velocity
type: AtomicFloat
value: 1.5f
mirror: always
- name: apz.fling_curve_function_x1
type: float
value: 0.0f
mirror: once
- name: apz.fling_curve_function_x2
type: float
value: 1.0f
mirror: once
- name: apz.fling_curve_function_y1
type: float
value: 0.0f
mirror: once
- name: apz.fling_curve_function_y2
type: float
value: 1.0f
mirror: once
- name: apz.fling_curve_threshold_inches_per_ms
type: AtomicFloat
value: -1.0f
mirror: always
- name: apz.fling_friction
type: AtomicFloat
value: 0.002f
mirror: always
- name: apz.fling_min_velocity_threshold
type: AtomicFloat
value: 0.5f
mirror: always
- name: apz.fling_stop_on_tap_threshold
type: AtomicFloat
value: 0.05f
mirror: always
- name: apz.fling_stopped_threshold
type: AtomicFloat
value: 0.01f
mirror: always
- name: apz.frame_delay.enabled
type: RelaxedAtomicBool
value: true
mirror: always
#ifdef MOZ_WIDGET_GTK
- name: apz.gtk.kinetic_scroll.enabled
type: RelaxedAtomicBool
value: true
mirror: always
#endif
- name: apz.keyboard.enabled
type: bool
value: @IS_NOT_ANDROID@
mirror: once
- name: apz.keyboard.passive-listeners
type: RelaxedAtomicBool
value: @IS_NOT_ANDROID@
mirror: always
- name: apz.max_tap_time
type: RelaxedAtomicInt32
value: 300
mirror: always
- name: apz.max_velocity_inches_per_ms
type: AtomicFloat
value: -1.0f
mirror: always
- name: apz.max_velocity_queue_size
type: uint32_t
value: 5
mirror: once
- name: apz.min_skate_speed
type: AtomicFloat
value: 1.0f
mirror: always
- name: apz.minimap.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: apz.one_touch_pinch.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: apz.overscroll.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: apz.overscroll.min_pan_distance_ratio
type: AtomicFloat
value: 1.0f
mirror: always
- name: apz.overscroll.stop_distance_threshold
type: AtomicFloat
value: 5.0f
mirror: always
- name: apz.paint_skipping.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: apz.peek_messages.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Fetch displayport updates early from the message queue.
- name: apz.pinch_lock.mode
type: RelaxedAtomicInt32
value: 1
mirror: always
- name: apz.pinch_lock.scroll_lock_threshold
type: AtomicFloat
value: 1.0f / 32.0f # 1/32 inches
mirror: always
- name: apz.pinch_lock.span_breakout_threshold
type: AtomicFloat
value: 1.0f / 32.0f # 1/32 inches
mirror: always
- name: apz.pinch_lock.span_lock_threshold
type: AtomicFloat
value: 1.0f / 32.0f # 1/32 inches
mirror: always
- name: apz.pinch_lock.buffer_max_age
type: int32_t
value: 50 # milliseconds
mirror: once
- name: apz.popups.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# Whether to print the APZC tree for debugging.
- name: apz.printtree
type: RelaxedAtomicBool
value: false
mirror: always
- name: apz.record_checkerboarding
type: RelaxedAtomicBool
value: @IS_NIGHTLY_BUILD@
mirror: always
- name: apz.second_tap_tolerance
type: AtomicFloat
value: 0.5f
mirror: always
- name: apz.test.fails_with_native_injection
type: RelaxedAtomicBool
value: false
mirror: always
- name: apz.test.logging_enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: apz.touch_move_tolerance
type: AtomicFloat
value: 0.1f
mirror: always
- name: apz.touch_start_tolerance
type: AtomicFloat
value: 0.1f
mirror: always
- name: apz.velocity_bias
type: AtomicFloat
value: 0.0f
mirror: always
- name: apz.velocity_relevance_time_ms
type: RelaxedAtomicUint32
value: 150
mirror: always
- name: apz.x_skate_highmem_adjust
type: AtomicFloat
value: 0.0f
mirror: always
- name: apz.x_skate_size_multiplier
type: AtomicFloat
value: 1.25f
mirror: always
- name: apz.x_stationary_size_multiplier
type: AtomicFloat
value: 1.5f
mirror: always
- name: apz.y_skate_highmem_adjust
type: AtomicFloat
value: 0.0f
mirror: always
- name: apz.y_skate_size_multiplier
type: AtomicFloat
#if defined(MOZ_WIDGET_ANDROID)
value: 1.5f
#else
value: 3.5f
#endif
mirror: always
- name: apz.y_stationary_size_multiplier
type: AtomicFloat
#if defined(MOZ_WIDGET_ANDROID)
value: 1.5f
#else
value: 3.5f
#endif
mirror: always
- name: apz.zoom_animation_duration_ms
type: RelaxedAtomicInt32
value: 250
mirror: always
- name: apz.scale_repaint_delay_ms
type: RelaxedAtomicInt32
value: 500
mirror: always
- name: apz.relative-update.enabled
type: RelaxedAtomicBool
value: true
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "beacon."
#---------------------------------------------------------------------------
# Is support for Navigator.sendBeacon enabled?
- name: beacon.enabled
type: bool
value: true
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "bidi."
#---------------------------------------------------------------------------
# Whether delete and backspace should immediately delete characters not
# visually adjacent to the caret, or adjust the visual position of the caret
# on the first keypress and delete the character on a second keypress
- name: bidi.edit.delete_immediately
type: bool
value: true
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "browser."
#---------------------------------------------------------------------------
- name: browser.active_color
type: String
value: "#EE0000"
mirror: never
- name: browser.anchor_color
type: String
value: "#0000EE"
mirror: never
# See http://dev.w3.org/html5/spec/forms.html#attr-fe-autofocus
- name: browser.autofocus
type: bool
value: true
mirror: always
- name: browser.cache.offline.enable
type: bool
value: true
mirror: always
- name: browser.cache.offline.storage.enable
type: bool
#ifdef EARLY_BETA_OR_EARLIER
value: false
#else
value: true
#endif
mirror: always
- name: browser.cache.disk.enable
type: RelaxedAtomicBool
value: true
mirror: always
- name: browser.cache.memory.enable
type: RelaxedAtomicBool
value: true
mirror: always
# Limit of recent metadata we keep in memory for faster access, in KB.
- name: browser.cache.disk.metadata_memory_limit
type: RelaxedAtomicUint32
value: 250 # 0.25 MB
mirror: always
# Does the user want smart-sizing?
- name: browser.cache.disk.smart_size.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Enable/Disable Origin based cache isolation
- name: browser.cache.cache_isolation
type: RelaxedAtomicBool
value: false
mirror: always
# -1 = determine dynamically, 0 = none, n = memory capacity in kilobytes.
- name: browser.cache.memory.capacity
type: RelaxedAtomicInt32
#ifdef ANDROID
value: 1024
#else
value: -1
#endif
mirror: always
# When smartsizing is disabled we could potentially fill all disk space by
# cache data when the disk capacity is not set correctly. To avoid that we
# check the free space every time we write some data to the cache. The free
# space is checked against two limits. Once the soft limit is reached we start
# evicting the least useful entries, when we reach the hard limit writing to
# the entry fails.
- name: browser.cache.disk.free_space_soft_limit
type: RelaxedAtomicUint32
value: 5 * 1024 # 5MB
mirror: always
- name: browser.cache.disk.free_space_hard_limit
type: RelaxedAtomicUint32
value: 1024 # 1MB
mirror: always
# The number of chunks we preload ahead of read. One chunk currently has
# 256kB.
- name: browser.cache.disk.preload_chunk_count
type: RelaxedAtomicUint32
value: 4 # 1 MB of read ahead
mirror: always
# Max-size (in KB) for entries in disk cache. Set to -1 for no limit.
# (Note: entries bigger than 1/8 of disk-cache are never cached)
- name: browser.cache.disk.max_entry_size
type: RelaxedAtomicUint32
value: 50 * 1024 # 50 MB
mirror: always
# Max-size (in KB) for entries in memory cache. Set to -1 for no limit.
# (Note: entries bigger than than 90% of the mem-cache are never cached.)
- name: browser.cache.memory.max_entry_size
type: RelaxedAtomicInt32
value: 5 * 1024
mirror: always
# Memory limit (in kB) for new cache data not yet written to disk. Writes to
# the cache are buffered and written to disk on background with low priority.
# With a slow persistent storage these buffers may grow when data is coming
# fast from the network. When the amount of unwritten data is exceeded, new
# writes will simply fail. We have two buckets, one for important data
# (priority) like html, css, fonts and js, and one for other data like images,
# video, etc.
# Note: 0 means no limit.
- name: browser.cache.disk.max_chunks_memory_usage
type: RelaxedAtomicUint32
value: 40 * 1024
mirror: always
- name: browser.cache.disk.max_priority_chunks_memory_usage
type: RelaxedAtomicUint32
value: 40 * 1024
mirror: always
# Number of seconds the cache spends writing pending data and closing files
# after shutdown has been signalled. Past that time data is not written and
# files are left open for the OS to clean up.
- name: browser.cache.max_shutdown_io_lag
type: RelaxedAtomicUint32
value: 2
mirror: always
- name: browser.contentblocking.database.enabled
type: bool
value: false
mirror: always
# How many recent block/unblock actions per origins we remember in the
# Content Blocking log for each top-level window.
- name: browser.contentblocking.originlog.length
type: uint32_t
value: 32
mirror: always
- name: browser.display.background_color
type: String
value: "#FFFFFF"
mirror: never
# 0 = default: always, except in high contrast mode
# 1 = always
# 2 = never
- name: browser.display.document_color_use
type: RelaxedAtomicUint32
value: 0
mirror: always
rust: true
# This pref dictates whether or not backplates and background images
# are to be drawn, when in high-contrast mode:
# false: do not draw backplates or render background images
# true: render background images and draw backplates
# This condition is only considered when high-contrast mode is enabled
# in Firefox, ie. when the user has:
# (1) mUseAccessibilityMode set to true (Widows high-contrast mode is on)
# AND browser.display.document_color_use set to 0
# (only with high-contrast themes) OR
# (2) browser.display.document_color_use set to 2 (always)
- name: browser.display.permit_backplate
type: RelaxedAtomicBool
value: @IS_EARLY_BETA_OR_EARLIER@
mirror: always
rust: true
- name: browser.display.focus_ring_on_anything
type: bool
value: false
mirror: always
- name: browser.display.focus_ring_width
type: uint32_t
value: 1
mirror: always
- name: browser.display.focus_background_color
type: String
value: "#117722"
mirror: never
# Focus ring border style.
# 0 = solid border, 1 = dotted border
- name: browser.display.focus_ring_style
type: uint32_t
value: 1
mirror: always
- name: browser.display.focus_text_color
type: String
value: "#ffffff"
mirror: never
- name: browser.display.foreground_color
type: String
value: "#000000"
mirror: never
- name: browser.display.show_focus_rings
type: bool
# Focus rings are not shown on Mac or Android by default.
#if defined(XP_MACOSX) || defined(ANDROID)
value: false
#else
value: true
#endif
mirror: always
# In theory: 0 = never, 1 = quick, 2 = always, though we always just use it as
# a bool!
- name: browser.display.use_document_fonts
type: RelaxedAtomicInt32
value: 1
mirror: always
rust: true
- name: browser.display.use_focus_colors
type: bool
value: false
mirror: always
- name: browser.display.use_system_colors
type: bool
value: false
mirror: always
- name: browser.dom.window.dump.enabled
type: RelaxedAtomicBool
value: @IS_NOT_MOZILLA_OFFICIAL@
mirror: always
# Fix up common scheme typos?
- name: browser.fixup.typo.scheme
type: bool
value: true
mirror: always
- name: browser.fixup.dns_first_for_single_words
type: bool
value: false
mirror: always
# Render animations and videos as a solid color
- name: browser.measurement.render_anims_and_video_solid
type: RelaxedAtomicBool
value: false
mirror: always
# Blocked plugin content
- name: browser.safebrowsing.blockedURIs.enabled
type: bool
value: true
mirror: always
# Malware protection
- name: browser.safebrowsing.malware.enabled
type: bool
value: true
mirror: always
# Password protection
- name: browser.safebrowsing.passwords.enabled
type: bool
value: false
mirror: always
# Phishing protection
- name: browser.safebrowsing.phishing.enabled
type: bool
value: true
mirror: always
# Maximum size for an array to store the safebrowsing prefixset.
- name: browser.safebrowsing.prefixset_max_array_size
type: RelaxedAtomicUint32
value: 512*1024
mirror: always
# ContentSessionStore prefs
# Maximum number of bytes of DOMSessionStorage data we collect per origin.
- name: browser.sessionstore.dom_storage_limit
type: uint32_t
value: 2048
mirror: always
# If set, use DocumentChannel with nsDocShell in place of HttpChannel.
- name: browser.tabs.documentchannel
type: bool
#if !defined(ANDROID)
value: @IS_NIGHTLY_BUILD@
#else
value: false # See bug 1589982.
#endif
mirror: always
- name: browser.tabs.remote.desktopbehavior
type: bool
value: false
mirror: always
- name: browser.tabs.remote.force-paint
type: bool
value: true
mirror: always
# When this pref is enabled document loads with a mismatched
# Cross-Origin-Embedder-Policy header will fail to load
- name: browser.tabs.remote.useCrossOriginEmbedderPolicy
type: bool
value: false
mirror: always
# When this pref is enabled top level loads with a mismatched
# Cross-Origin-Opener-Policy header will be loaded in a separate process.
- name: browser.tabs.remote.useCrossOriginOpenerPolicy
type: bool
value: false
mirror: always
# When this pref is enabled, the browser will check no-cors responses that
# have the Cross-Origin-Resource-Policy header and will fail the request if
# the origin of the resource's loading document doesn't match the origin
# (or base domain) of the loaded resource.
- name: browser.tabs.remote.useCORP
type: bool
value: false
mirror: always
# The percentage of the screen that needs to be scrolled before toolbar
# manipulation is allowed.
- name: browser.ui.scroll-toolbar-threshold
type: RelaxedAtomicInt32
value: 10
mirror: always
# When true, zooming will be enabled on all sites, even ones that declare
# user-scalable=no.
- name: browser.ui.zoom.force-user-scalable
type: RelaxedAtomicBool
value: false
mirror: always
- name: browser.underline_anchors
type: bool
value: true
mirror: always
- name: browser.viewport.desktopWidth
type: RelaxedAtomicInt32
value: 980
mirror: always
- name: browser.visited_color
type: String
value: "#551A8B"
mirror: never
# Enable xul error pages.
- name: browser.xul.error_pages.enabled
type: bool
value: true
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "canvas."
#---------------------------------------------------------------------------
# Limit for the canvas image cache. 0 means unlimited.
- name: canvas.image.cache.limit
type: int32_t
value: 0
mirror: always
# Add support for canvas path objects
- name: canvas.path.enabled
type: bool
value: true
mirror: always
- name: canvas.capturestream.enabled
type: bool
value: true
mirror: always
# Is support for CanvasRenderingContext2D.filter enabled?
- name: canvas.filters.enabled
type: bool
value: true
mirror: always
# Provide ability to turn on support for canvas focus rings.
- name: canvas.focusring.enabled
type: bool
value: true
mirror: always
# Is support for CanvasRenderingContext2D's hitRegion APIs enabled?
- name: canvas.hitregions.enabled
type: bool
value: false
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "channelclassifier."
#---------------------------------------------------------------------------
- name: channelclassifier.allowlist_example
type: bool
value: false
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "clipboard."
#---------------------------------------------------------------------------
# Clipboard behavior.
- name: clipboard.autocopy
type: bool
#if !defined(ANDROID) && !defined(XP_MACOSX) && defined(XP_UNIX)
value: true
#else
value: false
#endif
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "consoleservice."
#---------------------------------------------------------------------------
#if defined(ANDROID)
# Disable sending console to logcat on release builds.
- name: consoleservice.logcat
type: RelaxedAtomicBool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
#endif
#---------------------------------------------------------------------------
# Prefs starting with "content."
#---------------------------------------------------------------------------
- name: content.cors.disable
type: bool
value: false
mirror: always
# Back off timer notification after count.
# -1 means never.
- name: content.notify.backoffcount
type: int32_t
value: -1
mirror: always
# Notification interval in microseconds.
# The notification interval has a dramatic effect on how long it takes to
# initially display content for slow connections. The current value
# provides good incremental display of content without causing an increase
# in page load time. If this value is set below 1/10 of a second it starts
# to impact page load performance.
# See bugzilla bug 72138 for more info.
- name: content.notify.interval
type: int32_t
value: 120000
mirror: always
# Do we notify based on time?
- name: content.notify.ontimer
type: bool
value: true
mirror: always
# How many times to deflect in interactive mode.
- name: content.sink.interactive_deflect_count
type: int32_t
value: 0
mirror: always
# How many times to deflect in perf mode.
- name: content.sink.perf_deflect_count
type: int32_t
value: 200
mirror: always
# Parse mode for handling pending events.
# 0 = don't check for pending events
# 1 = don't deflect if there are pending events
# 2 = bail if there are pending events
- name: content.sink.pending_event_mode
type: int32_t
# ifdef XP_WIN
value: 1
# else
value: 0
# endif
mirror: always
# How often to probe for pending events. 1 = every token.
- name: content.sink.event_probe_rate
type: int32_t
value: 1
mirror: always
# How long to stay off the event loop in interactive mode.
- name: content.sink.interactive_parse_time
type: int32_t
value: 3000
mirror: always
# How long to stay off the event loop in perf mode.
- name: content.sink.perf_parse_time
type: int32_t
value: 360000
mirror: always
# How long to be in interactive mode after an event.
- name: content.sink.interactive_time
type: uint32_t
value: 750000
mirror: always
# How long to stay in perf mode after initial loading.
- name: content.sink.initial_perf_time
type: uint32_t
value: 2000000
mirror: always
# Should we switch between perf-mode and interactive-mode?
# 0 = Switch
# 1 = Interactive mode
# 2 = Perf mode
- name: content.sink.enable_perf_mode
type: int32_t
value: 0
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "device."
#---------------------------------------------------------------------------
# Is support for the device sensors API enabled?
- name: device.sensors.enabled
type: bool
value: true
mirror: always
- name: device.sensors.ambientLight.enabled
type: bool
value: false
mirror: always
- name: device.sensors.motion.enabled
type: bool
value: true
mirror: always
- name: device.sensors.orientation.enabled
type: bool
value: true
mirror: always
- name: device.sensors.proximity.enabled
type: bool
value: false
mirror: always
- name: device.sensors.test.events
type: bool
value: false
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "devtools."
#---------------------------------------------------------------------------
# Tells if DevTools have been explicitely enabled by the user. This pref
# allows to disable all features related to DevTools for users that never use
# them. Until bug 1361080 lands, we always consider them enabled.
- name: devtools.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: devtools.console.stdout.chrome
type: RelaxedAtomicBool
value: @IS_NOT_MOZILLA_OFFICIAL@
mirror: always
- name: devtools.console.stdout.content
type: RelaxedAtomicBool
value: false
mirror: always
- name: devtools.toolbox.force-chrome-prefs
type: RelaxedAtomicBool
value: true
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "docshell."
#---------------------------------------------------------------------------
# Used to indicate whether session history listeners should be notified
# about content viewer eviction. Used only for testing.
- name: docshell.shistory.testing.bfevict
type: bool
value: false
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "dom."
#---------------------------------------------------------------------------
# Whether window.mozPaintCount is exposed to the web.
- name: dom.mozPaintCount.enabled
type: bool
value: false
mirror: always
# Allow cut/copy
- name: dom.allow_cut_copy
type: bool
value: true
mirror: always
- name: dom.allow_XUL_XBL_for_file
type: bool
value: false
mirror: always
# Is support for automatically removing replaced filling animations enabled?
- name: dom.animations-api.autoremove.enabled
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
# Is support for composite operations from the Web Animations API enabled?
- name: dom.animations-api.compositing.enabled
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
# Is support for the core interfaces of Web Animations API enabled?
- name: dom.animations-api.core.enabled
type: bool
value: true
mirror: always
# Is support for Document.getAnimations() and Element.getAnimations()
# supported?
#
# Before enabling this by default, make sure also CSSPseudoElement interface
# has been spec'ed properly, or we should add a separate pref for
# CSSPseudoElement interface. See Bug 1174575 for further details.
- name: dom.animations-api.getAnimations.enabled
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
# Is support for animations from the Web Animations API without 0%/100%
# keyframes enabled?
- name: dom.animations-api.implicit-keyframes.enabled
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
# Is support for timelines from the Web Animations API enabled?
- name: dom.animations-api.timelines.enabled
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
# Is support for AudioWorklet enabled?
- name: dom.audioworklet.enabled
type: bool
value: false
mirror: always
# Is support for Navigator.getBattery enabled?
- name: dom.battery.enabled
type: bool
value: true
mirror: always
# Block multiple external protocol URLs in iframes per single event.
- name: dom.block_external_protocol_in_iframes
type: bool
value: true
mirror: always
# Block multiple window.open() per single event.
- name: dom.block_multiple_popups
type: bool
value: true
mirror: always
# The maximum number of popup that is allowed to be opened. Set to -1 for no
# limit.
- name: dom.popup_maximum
type: int32_t
value: 20
mirror: always
# Whether window.location.reload() and window.history.go(0) should be blocked
# if called directly from a window resize event handler.
#
# This used to be necessary long ago to prevent terrible UX when using stuff
# like TypeAheadFind (bug 258917), but it also causes compat issues on mobile
# (bug 1570566).
#
# So for now disable it on Android and Desktop Nightly, to see if we have any
# desktop regression before removing it completely. Note that this means that
# non-nightly RDM behaves different than Android in this case.
- name: dom.block_reload_from_resize_event_handler
type: bool
#if defined(MOZ_WIDGET_ANDROID) || defined(NIGHTLY_BUILD)
value: false
#else
value: true
#endif
mirror: always
# SW Cache API
- name: dom.caches.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: dom.caches.testing.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# Disable capture attribute for input elements; only supported on GeckoView.
- name: dom.capture.enabled
type: bool
value: false
mirror: always
# Whether Mozilla specific "text" event should be dispatched only in the
# system group or not in content.
- name: dom.compositionevent.text.dispatch_only_system_group_in_content
type: bool
value: true
mirror: always
# Any how many seconds we allow external protocol URLs in iframe when not in
# single events
- name: dom.delay.block_external_protocol_in_iframes
type: uint32_t
value: 10 # in seconds
mirror: always
# HTML <dialog> element
- name: dom.dialog_element.enabled
type: bool
value: false
mirror: always
# Only propagate the open window click permission if the setTimeout() is equal
# to or less than this value.
- name: dom.disable_open_click_delay
type: int32_t
value: 1000
mirror: always
- name: dom.disable_open_during_load
type: bool
value: false
mirror: always
- name: dom.enable_window_print
type: bool
value: @IS_NOT_ANDROID@
mirror: always
- name: dom.element.transform-getters.enabled
type: bool
value: false
mirror: always
# Is support for Performance.mozMemory enabled?
- name: dom.enable_memory_stats
type: bool
value: false
mirror: always
# Enable Performance API
# Whether nonzero values can be returned from performance.timing.*
- name: dom.enable_performance
type: RelaxedAtomicBool
value: true
mirror: always
# Enable Performance Observer API
- name: dom.enable_performance_observer
type: RelaxedAtomicBool
value: true
mirror: always
# Whether resource timing will be gathered and returned by performance.GetEntries*
- name: dom.enable_resource_timing
type: bool
value: true
mirror: always
# Whether performance.GetEntries* will contain an entry for the active document
- name: dom.enable_performance_navigation_timing
type: bool
value: true
mirror: always
# If this is true, it's allowed to fire "cut", "copy" and "paste" events.
# Additionally, "input" events may expose clipboard content when inputType
# is "insertFromPaste" or something.
- name: dom.event.clipboardevents.enabled
type: bool
value: true
mirror: always
# Enable clipboard readText() and writeText() by default
- name: dom.events.asyncClipboard
type: bool
value: true
mirror: always
# Disable clipboard read() and write() by default
- name: dom.events.asyncClipboard.dataTransfer
type: bool
value: false
mirror: always
# This pref controls whether or not the `protected` dataTransfer state is
# enabled. If the `protected` dataTransfer stae is disabled, then the
# DataTransfer will be read-only whenever it should be protected, and will not
# be disconnected after a drag event is completed.
- name: dom.events.dataTransfer.protected.enabled
type: bool
value: false
mirror: always
# User interaction timer interval, in ms
- name: dom.events.user_interaction_interval
type: uint32_t
value: 5000
mirror: always
# Whether to expose test interfaces of various sorts
- name: dom.expose_test_interfaces
type: bool
value: false
mirror: always
- name: dom.fetchObserver.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# Allow the content process to create a File from a path. This is allowed just
# on parent process, on 'file' Content process, or for testing.
- name: dom.file.createInChild
type: RelaxedAtomicBool
value: false
mirror: always
# Enable formData event
- name: dom.formdata.event.enabled
type: bool
value: true
mirror: always
# Support @autocomplete values for form autofill feature.
- name: dom.forms.autocomplete.formautofill
type: bool
value: false
mirror: always
# This pref just controls whether we format the number with grouping separator
# characters when the internal value is set or updated. It does not stop the
# user from typing in a number and using grouping separators.
- name: dom.forms.number.grouping
type: bool
value: false
mirror: always
# Whether the Gamepad API is enabled
- name: dom.gamepad.enabled
type: bool
value: true
mirror: always
# Is Gamepad Extension API enabled?
- name: dom.gamepad.extensions.enabled
type: bool
value: true
mirror: always
# Is LightIndicator API enabled in Gamepad Extension API?
- name: dom.gamepad.extensions.lightindicator
type: bool
value: false
mirror: always
# Is MultiTouch API enabled in Gamepad Extension API?
- name: dom.gamepad.extensions.multitouch
type: bool
value: false
mirror: always
# Is Gamepad vibrate haptic feedback function enabled?
- name: dom.gamepad.haptic_feedback.enabled
type: bool
value: true
mirror: always
- name: dom.gamepad.non_standard_events.enabled
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
- name: dom.gamepad.test.enabled
type: bool
value: false
mirror: always
# W3C draft ImageCapture API
- name: dom.imagecapture.enabled
type: bool
value: false
mirror: always
# Enable passing the "storage" option to indexedDB.open.
- name: dom.indexedDB.storageOption.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# Whether we conform to Input Events Level 1 or Input Events Level 2.
# true: conforming to Level 1
# false: conforming to Level 2
- name: dom.input_events.conform_to_level_1
type: bool
value: true
mirror: always
# Enable not moving the cursor to end when a text input or textarea has .value
# set to the value it already has. By default, enabled.
- name: dom.input.skip_cursor_move_for_same_value_set
type: bool
value: true
mirror: always
- name: dom.IntersectionObserver.enabled
type: bool
value: true
mirror: always
- name: dom.ipc.cancel_content_js_when_navigating
type: bool
value: true
mirror: always
# How often to check for CPOW timeouts (ms). CPOWs are only timed
# out by the hang monitor.
- name: dom.ipc.cpow.timeout
type: uint32_t
value: 500
mirror: always
# Allow Flash async drawing mode in 64-bit release builds.
- name: dom.ipc.plugins.asyncdrawing.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# How long we wait before unloading an idle plugin process.
- name: dom.ipc.plugins.unloadTimeoutSecs
type: RelaxedAtomicUint32
value: 30
mirror: always
# Enable e10s hang monitoring (slow script checking and plugin hang detection).
- name: dom.ipc.processHangMonitor
type: bool
value: true
mirror: once
# Whether we report such process hangs
- name: dom.ipc.reportProcessHangs
type: RelaxedAtomicBool
# Don't report hangs in DEBUG builds. They're too slow and often a
# debugger is attached.
#ifdef DEBUG
value: false
#else
value: true
#endif
mirror: always
- name: dom.ipc.tabs.disabled
type: bool
value: false
mirror: always
# Process launch delay (im milliseconds).
- name: dom.ipc.processPrelaunch.delayMs
type: uint32_t
# This number is fairly arbitrary ... the intention is to put off
# launching another app process until the last one has finished
# loading its content, to reduce CPU/memory/IO contention.
value: 1000
mirror: always
- name: dom.ipc.processPriorityManager.enabled
type: bool
value: false
mirror: always
- name: dom.ipc.processPriorityManager.testMode
type: bool
value: false
mirror: always
- name: dom.ipc.processPriorityManager.backgroundPerceivableGracePeriodMS
type: uint32_t
value: 0
mirror: always
- name: dom.ipc.processPriorityManager.backgroundGracePeriodMS
type: uint32_t
value: 0
mirror: always
# Is support for input type=date and type=time enabled?
- name: dom.forms.datetime
type: bool
value: true
mirror: always
# Is support for HTMLInputElement.inputMode enabled?
- name: dom.forms.inputmode
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
# Enable Directory API. By default, disabled.
- name: dom.input.dirpicker
type: bool
value: false
mirror: always
# Is support for InputEvent.data enabled?
- name: dom.inputevent.data.enabled
type: bool
value: true
mirror: always
# Is support for InputEvent.dataTransfer enabled?
- name: dom.inputevent.datatransfer.enabled
type: bool
value: true
mirror: always
# Is support for InputEvent.inputType enabled?
- name: dom.inputevent.inputtype.enabled
type: bool
value: true
mirror: always
# How long a content process can take before closing its IPC channel
# after shutdown is initiated. If the process exceeds the timeout,
# we fear the worst and kill it.
- name: dom.ipc.tabs.shutdownTimeoutSecs
type: RelaxedAtomicUint32
#if !defined(DEBUG) && !defined(MOZ_ASAN) && !defined(MOZ_VALGRIND) && !defined(MOZ_TSAN)
value: 5
#else
value: 0
#endif
mirror: always
- name: dom.ipc.cpows.forbid-unsafe-from-browser
type: bool
value: false
mirror: always
- name: dom.ipc.cpows.log.enabled
type: bool
value: false
mirror: always
- name: dom.ipc.cpows.log.stack
type: bool
value: false
mirror: always
# Whether a native event loop should be used in the content process.
- name: dom.ipc.useNativeEventProcessing.content
type: RelaxedAtomicBool
#if defined(XP_WIN) || defined(XP_MACOSX)
value: false
#else
value: true
#endif
mirror: always
# If this is true, TextEventDispatcher dispatches keydown and keyup events
# even during composition (keypress events are never fired during composition
# even if this is true).
- name: dom.keyboardevent.dispatch_during_composition
type: bool
value: true
mirror: always
# If this is true, keypress events for non-printable keys are dispatched only
# for event listeners of the system event group in web content.
- name: dom.keyboardevent.keypress.dispatch_non_printable_keys_only_system_group_in_content
type: bool
value: true
mirror: always
# If this is true, "keypress" event's keyCode value and charCode value always
# become same if the event is not created/initialized by JS.
- name: dom.keyboardevent.keypress.set_keycode_and_charcode_to_same_value
type: bool
value: true
mirror: always
- name: dom.largeAllocation.forceEnable
type: bool
value: false
mirror: always
- name: dom.largeAllocation.testing.allHttpLoads
type: bool
value: false
mirror: always
# Whether the disabled attribute in HTMLLinkElement disables the sheet loading
# altogether, or forwards to the inner stylesheet method without attribute
# reflection.
#
# Historical behavior is the second, the first is being discussed at:
# https://github.com/whatwg/html/issues/3840
- name: dom.link.disabled_attribute.enabled
type: bool
value: true
mirror: always
# Whether window.onappinstalled from "W3C Web Manifest" is enabled
- name: dom.manifest.onappinstalled
type: bool
value: false
mirror: always
# Enable mapped array buffer by default.
- name: dom.mapped_arraybuffer.enabled
type: bool
value: true
mirror: always
# This pref is used to enable/disable the `document.autoplayPolicy` API which
# returns a enum string which presents current autoplay policy and can change
# overtime based on user session activity.
- name: dom.media.autoplay.autoplay-policy-api
type: bool
value: false
mirror: always
# Media Session API
- name: dom.media.mediasession.enabled
type: bool
value: false
mirror: always
# Enable meta-viewport support in remote APZ-enabled frames.
- name: dom.meta-viewport.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: dom.metaElement.setCookie.allowed
type: bool
value: false
mirror: always
# Timeout clamp in ms for timeouts we clamp.
- name: dom.min_timeout_value
type: int32_t
value: 4
mirror: always
# Timeout clamp in ms for background windows.
- name: dom.min_background_timeout_value
type: int32_t
value: 1000
mirror: always
# Are missing-property use counters for certain DOM attributes enabled?
- name: dom.missing_prop_counters.enabled
type: bool
value: false
mirror: always
# Is support for module scripts (<script type="module">) enabled for content?
- name: dom.moduleScripts.enabled
type: bool
value: true
mirror: always
# Is support for mozBrowser frames enabled?
- name: dom.mozBrowserFramesEnabled
type: bool
value: false
mirror: always
# Whether we disable triggering mutation events for changes to style
# attribute via CSSOM.
# NOTE: This preference is used in unit tests. If it is removed or its default
# value changes, please update test_sharedMap_var_caches.js accordingly.
- name: dom.mutation-events.cssom.disabled
type: bool
value: true
mirror: always
# Network Information API
- name: dom.netinfo.enabled
type: RelaxedAtomicBool
value: @IS_ANDROID@
mirror: always
# Is support for Window.paintWorklet enabled?
- name: dom.paintWorklet.enabled
type: bool
value: false
mirror: always
# Enable/disable the PaymentRequest API
- name: dom.payments.request.enabled
type: bool
value: false
mirror: always
# Whether a user gesture is required to call PaymentRequest.prototype.show().
- name: dom.payments.request.user_interaction_required
type: bool
value: true
mirror: always
# Time in milliseconds for PaymentResponse to wait for
# the Web page to call complete().
- name: dom.payments.response.timeout
type: uint32_t
value: 5000
mirror: always
# Enable printing performance marks/measures to log
- name: dom.performance.enable_user_timing_logging
type: RelaxedAtomicBool
value: false
mirror: always
- name: dom.performance.children_results_ipc_timeout
type: uint32_t
value: 1000
mirror: always
# Enable notification of performance timing
- name: dom.performance.enable_notify_performance_timing
type: bool
value: false
mirror: always
# Is support for PerformanceTiming.timeToContentfulPaint enabled?
- name: dom.performance.time_to_contentful_paint.enabled
type: bool
value: false
mirror: always
# Is support for PerformanceTiming.timeToDOMContentFlushed enabled?
- name: dom.performance.time_to_dom_content_flushed.enabled
type: bool
value: false
mirror: always
# Is support for PerformanceTiming.timeToFirstInteractive enabled?
- name: dom.performance.time_to_first_interactive.enabled
type: bool
value: false
mirror: always
# Is support for PerformanceTiming.timeToNonBlankPaint enabled?
- name: dom.performance.time_to_non_blank_paint.enabled
type: bool
value: false
mirror: always
# Is support for Permissions.revoke enabled?
- name: dom.permissions.revoke.enable
type: bool
value: false
mirror: always
# Whether we should show the placeholder when the element is focused but empty.
- name: dom.placeholder.show_on_focus
type: bool
value: true
mirror: always
# Is support for Element.requestPointerLock enabled?
# This is added for accessibility purpose. When user has no way to exit
# pointer lock (e.g. no keyboard available), they can use this pref to
# disable the Pointer Lock API altogether.
- name: dom.pointer-lock.enabled
type: bool
value: true
mirror: always
# re-SAB; Whether allow postMessage a sharedArrayBuffer
- name: dom.postMessage.sharedArrayBuffer.withCOOP_COEP
type: RelaxedAtomicBool
value: false
mirror: always
# Overridden in all.js on RELEASE_OR_BETA in order to add the locked attribute.
- name: dom.postMessage.sharedArrayBuffer.bypassCOOP_COEP.insecure.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# Presentation API
- name: dom.presentation.enabled
type: bool
#if defined(ANDROID)
value: @IS_NOT_RELEASE_OR_BETA@
#else
value: false
#endif
mirror: always
- name: dom.presentation.controller.enabled
type: bool
#if defined(ANDROID)
value: @IS_NOT_RELEASE_OR_BETA@
#else
value: false
#endif
mirror: always
- name: dom.presentation.receiver.enabled
type: bool
#if defined(ANDROID)
value: @IS_NOT_RELEASE_OR_BETA@
#else
value: false
#endif
mirror: always
- name: dom.presentation.testing.simulate-receiver
type: bool
value: false
mirror: always
# This currently only affects XHTML. For XUL the cache is always allowed.
- name: dom.prototype_document_cache.enabled
type: bool
value: true
mirror: always
# Push
- name: dom.push.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# Should we try to load origin information from the cache?
# See bug 1563023 for more details.
- name: dom.quotaManager.loadQuotaFromCache
type: RelaxedAtomicBool
value: true
mirror: always
# Preference that users can set to override temporary storage smart limit
# calculation.
- name: dom.quotaManager.temporaryStorage.fixedLimit
type: RelaxedAtomicInt32
value: -1
mirror: always
# Preference that users can set to override temporary storage smart limit
# calculation.
- name: dom.quotaManager.temporaryStorage.chunkSize
type: RelaxedAtomicUint32
value: 10 * 1024
mirror: always
# A pref that is used to enable testing features.
- name: dom.quotaManager.testing
type: SequentiallyConsistentAtomicBool
value: false
mirror: always
# Is support for Navigator.registerContentHandler enabled?
- name: dom.registerContentHandler.enabled
type: bool
value: false
mirror: always
# Reporting API.
- name: dom.reporting.enabled
type: RelaxedAtomicBool
value: @IS_NIGHTLY_BUILD@
mirror: always
- name: dom.reporting.testing.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: dom.reporting.featurePolicy.enabled
type: RelaxedAtomicBool
value: @IS_NIGHTLY_BUILD@
mirror: always
- name: dom.reporting.header.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# In seconds. The timeout to remove not-active report-to endpoints.
- name: dom.reporting.cleanup.timeout
type: uint32_t
value: 3600
mirror: always
# Any X seconds the reports are dispatched to endpoints.
- name: dom.reporting.delivering.timeout
type: uint32_t
value: 5
mirror: always
# How many times the delivering of a report should be tried.
- name: dom.reporting.delivering.maxFailures
type: uint32_t
value: 3
mirror: always
# How many reports should be stored in the report queue before being delivered.
- name: dom.reporting.delivering.maxReports
type: uint32_t
value: 100
mirror: always
# Enable requestIdleCallback API
- name: dom.requestIdleCallback.enabled
type: bool
value: true
mirror: always
#ifdef JS_BUILD_BINAST
- name: dom.script_loader.binast_encoding.domain.restrict
type: bool
value: true
mirror: always
- name: dom.script_loader.binast_encoding.enabled
type: RelaxedAtomicBool
value: false
mirror: always
#endif
# Whether to enable the JavaScript start-up cache. This causes one of the first
# execution to record the bytecode of the JavaScript function used, and save it
# in the existing cache entry. On the following loads of the same script, the
# bytecode would be loaded from the cache instead of being generated once more.
- name: dom.script_loader.bytecode_cache.enabled
type: bool
value: true
mirror: always
# Ignore the heuristics of the bytecode cache, and always record on the first
# visit. (used for testing purposes).
# Choose one strategy to use to decide when the bytecode should be encoded and
# saved. The following strategies are available right now:
# * -2 : (reader mode) The bytecode cache would be read, but it would never
# be saved.
# * -1 : (eager mode) The bytecode would be saved as soon as the script is
# seen for the first time, independently of the size or last access
# time.
# * 0 : (default) The bytecode would be saved in order to minimize the
# page-load time.
#
# Other values might lead to experimental strategies. For more details, have a
# look at: ScriptLoader::ShouldCacheBytecode function.
- name: dom.script_loader.bytecode_cache.strategy
type: int32_t
value: 0
mirror: always
# Is support for decoding external (non-inline) classic or module DOM scripts
# (i.e. anything but workers) as UTF-8, then directly compiling without
# inflating to UTF-16, enabled?
- name: dom.script_loader.external_scripts.utf8_parsing.enabled
type: bool
value: true
mirror: always
- name: dom.securecontext.whitelist_onions
type: bool
value: false
mirror: always
# This pref enables FeaturePolicy logic and the parsing of 'allow' attribute in
# HTMLIFrameElement objects.
- name: dom.security.featurePolicy.enabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# This pref enables the featurePolicy header support.
- name: dom.security.featurePolicy.header.enabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
- name: dom.security.respect_document_nosniff
type: RelaxedAtomicBool
value: true
mirror: always
# Expose the 'policy' attribute in document and HTMLIFrameElement
- name: dom.security.featurePolicy.webidl.enabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Is support for selection event APIs enabled?
- name: dom.select_events.enabled
type: bool
value: true
mirror: always
- name: dom.separate_event_queue_for_post_message.enabled
type: bool
value: true
mirror: always
- name: dom.serviceWorkers.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# If true. then the service worker interception and the ServiceWorkerManager
# will live in the parent process. This only takes effect on browser start.
# Note, this is not currently safe to use for normal browsing yet.
- name: dom.serviceWorkers.parent_intercept
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: never
- name: dom.serviceWorkers.testing.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# External.AddSearchProvider is deprecated and it will be removed in the next
# cycles.
- name: dom.sidebar.enabled
type: bool
value: true
mirror: always
# Whether automatic storage access granting heuristics should be turned on.
- name: dom.storage_access.auto_grants
type: bool
value: true
mirror: always
- name: dom.storage_access.auto_grants.delayed
type: bool
value: true
mirror: always
# Storage-access API.
- name: dom.storage_access.enabled
type: bool
value: false
mirror: always
# The maximum number of origins that a given third-party tracker is allowed
# to have concurrent access to before the user is presented with a storage
# access prompt. Only effective when the auto_grants pref is turned on.
- name: dom.storage_access.max_concurrent_auto_grants
type: int32_t
value: 5
mirror: always
# Enable Storage API for all platforms except Android.
- name: dom.storageManager.enabled
type: RelaxedAtomicBool
value: @IS_NOT_ANDROID@
mirror: always
# Should we abort LocalStorage requests when a sync message from parent is
# detected?
#
# LocalStorage is a synchronous API involving sync IPC from the child to the
# parent. Accessibility interfaces currently also involve different forms of
# synchronous parent-to-child communication. (See bug 1516136 comment 11 and
# comment 15.) Although LocalStorage NextGen no longer needs to consult the
# main thread, thereby eliminating the possibility of deadlock, the browser is
# very complex and so we have retained a fail-safe mechanism that will cause
# blocking LocalStorage operations to abort on synchronous IPC from the parent
# to the child.
#
# We are disabling this fail-safe mechanism because it is fundamentally visible
# to content when activated. When we abort the synchronous LocalStorage
# operation we throw an error which has the potential to break web content.
# This is not a hypothetical. In bug 1574569 content broke due to accessibility
# path aborting the LS call, but the LS call didn't need to abort because it
# was not at risk of deadlock.
#
# But we are retaining the preference in the event that regressions occur
# anywhere in the code-base that could cause a cascade that would result in
# deadlock. (There have been logic bugs in components that resulted in
# PBackground synchronously blocking in a way that could result in deadlock.)
# This allows us to re-enable the fail-safe with only a pref flip.
- name: dom.storage.abort_on_sync_parent_to_child_messages
type: bool
value: false
mirror: always
# LocalStorage data limit as determined by summing up the lengths of all string
# keys and values. This is consistent with the legacy implementation and other
# browser engines. This value should really only ever change in unit testing
# where being able to lower it makes it easier for us to test certain edge
# cases. Measured in KiBs.
- name: dom.storage.default_quota
type: RelaxedAtomicUint32
# Only allow relatively small amounts of data since performance of the
# synchronous IO is very bad. We are enforcing simple per-origin quota only.
value: 5 * 1024
mirror: always
# Is support for Storage test APIs enabled?
- name: dom.storage.testing
type: bool
value: false
mirror: always
# For area and anchor elements with target=_blank and no rel set to
# opener/noopener.
- name: dom.targetBlankNoOpener.enabled
type: bool
value: @IS_EARLY_BETA_OR_EARLIER@
mirror: always
# Is support for Selection.GetRangesForInterval enabled?
- name: dom.testing.selection.GetRangesForInterval
type: bool
value: false
mirror: always
- name: dom.testing.structuredclonetester.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: dom.testing.sync-content-blocking-notifications
type: bool
value: false
mirror: always
# Time (in ms) that it takes to regenerate 1ms.
- name: dom.timeout.background_budget_regeneration_rate
type: int32_t
value: 100
mirror: always
# Time (in ms) that it takes to regenerate 1ms.
- name: dom.timeout.foreground_budget_regeneration_rate
type: int32_t
value: 1
mirror: always
# Maximum value (in ms) for the background budget. Only valid for
# values greater than 0.
- name: dom.timeout.background_throttling_max_budget
type: int32_t
value: 50
mirror: always
# Maximum value (in ms) for the foreground budget. Only valid for
# values greater than 0.
- name: dom.timeout.foreground_throttling_max_budget
type: int32_t
value: -1
mirror: always
# The maximum amount a timeout can be delayed by budget throttling.
- name: dom.timeout.budget_throttling_max_delay
type: int32_t
value: 15000
mirror: always
# Turn on budget throttling by default.
- name: dom.timeout.enable_budget_timer_throttling
type: bool
value: true
mirror: always
# Should we defer timeouts and intervals while loading a page. Released
# on Idle or when the page is loaded.
- name: dom.timeout.defer_during_load
type: bool
value: true
mirror: always
# Maximum amount of time in milliseconds consecutive setTimeout()/setInterval()
# callback are allowed to run before yielding the event loop.
- name: dom.timeout.max_consecutive_callbacks_ms
type: uint32_t
value: 4
mirror: always
# Maximum deferral time for setTimeout/Interval in milliseconds
- name: dom.timeout.max_idle_defer_ms
type: uint32_t
value: 10*1000
mirror: always
# Delay in ms from document load until we start throttling background timeouts.
- name: dom.timeout.throttling_delay
type: int32_t
value: 30000
mirror: always
# UDPSocket API
- name: dom.udpsocket.enabled
type: bool
value: false
mirror: always
# Time limit, in milliseconds, for user gesture transient activation.
- name: dom.user_activation.transient.timeout
type: uint32_t
value: 5000
mirror: always
# Is support for Window.visualViewport enabled?
- name: dom.visualviewport.enabled
type: bool
value: false
mirror: always
# Is support for WebVR APIs enabled?
# Enabled by default in beta and release for Windows and OS X and for all
# platforms in nightly and aurora.
- name: dom.vr.enabled
type: RelaxedAtomicBool
#if defined(XP_WIN) || defined(XP_DARWIN) || !defined(RELEASE_OR_BETA)
value: true
#else
value: false
#endif
mirror: always
# It is often desirable to automatically start vr presentation when
# a user puts on the VR headset. This is done by emitting the
# Window.vrdisplayactivate event when the headset's sensors detect it
# being worn. This can result in WebVR content taking over the headset
# when the user is using it outside the browser or inadvertent start of
# presentation due to the high sensitivity of the proximity sensor in some
# headsets, so it is off by default.
- name: dom.vr.autoactivate.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# Minimum number of milliseconds that the browser will wait before
# attempting to poll again for connected VR controllers. The browser
# will not attempt to poll for VR controllers until it needs to use them.
- name: dom.vr.controller.enumerate.interval
type: RelaxedAtomicInt32
value: 1000
mirror: always
# The threshold value of trigger inputs for VR controllers.
- name: dom.vr.controller_trigger_threshold
type: AtomicFloat
value: 0.1f
mirror: always
# Minimum number of milliseconds that the browser will wait before
# attempting to poll again for connected VR displays. The browser
# will not attempt to poll for VR displays until it needs to use
# them, such as when detecting a WebVR site.
- name: dom.vr.display.enumerate.interval
type: RelaxedAtomicInt32
value: 5000
mirror: always
# The number of milliseconds since last frame start before triggering a new
# frame. When content is failing to submit frames on time or the lower level
# VR platform APIs are rejecting frames, it determines the rate at which RAF
# callbacks will be called.
- name: dom.vr.display.rafMaxDuration
type: RelaxedAtomicUint32
value: 50
mirror: always
# Minimum number of milliseconds the browser will wait before attempting
# to re-start the VR service after an enumeration returned no devices.
- name: dom.vr.external.notdetected.timeout
type: RelaxedAtomicInt32
value: 60000
mirror: always
# Minimum number of milliseconds the browser will wait before attempting
# to re-start the VR service after a VR API (eg, OpenVR or Oculus)
# requests that we shutdown and unload its libraries.
# To ensure that we don't interfere with VR runtime software auto-updates,
# we will not attempt to re-load the service until this timeout has elapsed.
- name: dom.vr.external.quit.timeout
type: RelaxedAtomicInt32
value: 10000
mirror: always
# Minimum number of milliseconds that the VR session will be kept
# alive after the browser and content no longer are using the
# hardware. If a VR multitasking environment, this should be set
# very low or set to 0.
- name: dom.vr.inactive.timeout
type: RelaxedAtomicInt32
value: 5000
mirror: always
# Maximum number of milliseconds the browser will wait for content to call
# VRDisplay.requestPresent after emitting vrdisplayactivate during VR
# link traversal. This prevents a long running event handler for
# vrdisplayactivate from later calling VRDisplay.requestPresent, which would
# result in a non-responsive browser in the VR headset.
- name: dom.vr.navigation.timeout
type: RelaxedAtomicInt32
value: 5000
mirror: always
# Oculus device
- name: dom.vr.oculus.enabled
type: bool
#if defined(HAVE_64BIT_BUILD) && !defined(ANDROID)
# We are only enabling WebVR by default on 64-bit builds (Bug 1384459).
value: true
#else
# On Android, this pref is irrelevant.
value: false
#endif
mirror: once
# When enabled, Oculus sessions may be created with the ovrInit_Invisible
# flag if a page is using tracking but not presenting. When a page
# begins presenting VR frames, the session will be re-initialized without
# the flag. This eliminates the "Firefox not responding" warnings in
# the headset, but might not be compatible with all versions of the Oculus
# runtime.
- name: dom.vr.oculus.invisible.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Minimum number of milliseconds after content has stopped VR presentation
# before the Oculus session is re-initialized to an invisible / tracking
# only mode. If this value is too high, users will need to wait longer
# after stopping WebVR presentation before automatically returning to the
# Oculus home interface. (They can immediately return to the Oculus Home
# interface through the Oculus HUD without waiting this duration)
# If this value is too low, the Oculus Home interface may be visible
# momentarily during VR link navigation.
- name: dom.vr.oculus.present.timeout
type: RelaxedAtomicInt32
value: 500
mirror: always
# OpenVR device
- name: dom.vr.openvr.enabled
type: bool
#if !defined(HAVE_64BIT_BUILD) && !defined(ANDROID)
# We are only enabling WebVR by default on 64-bit builds (Bug 1384459).
value: false
#elif defined(XP_WIN) || defined(XP_MACOSX)
# We enable OpenVR by default for Windows and macOS.
value: true
#else
# See Bug 1310663 (Linux). On Android, this pref is irrelevant.
value: false
#endif
mirror: once
- name: dom.vr.openvr.action_input
type: bool
value: true
mirror: once
# OSVR device
- name: dom.vr.osvr.enabled
type: bool
value: false
mirror: once
# Pose prediction reduces latency effects by returning future predicted HMD
# poses to callers of the WebVR API. This currently only has an effect for
# Oculus Rift on SDK 0.8 or greater.
- name: dom.vr.poseprediction.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Enable a separate process for VR module.
- name: dom.vr.process.enabled
type: bool
#if defined(XP_WIN)
value: true
#else
value: false
#endif
mirror: once
- name: dom.vr.process.startup_timeout_ms
type: int32_t
value: 5000
mirror: once
# Puppet device, used for simulating VR hardware within tests and dev tools.
- name: dom.vr.puppet.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# Starting VR presentation is only allowed within a user gesture or event such
# as VRDisplayActivate triggered by the system. dom.vr.require-gesture allows
# this requirement to be disabled for special cases such as during automated
# tests or in a headless kiosk system.
- name: dom.vr.require-gesture
type: RelaxedAtomicBool
value: true
mirror: always
# Is support for WebXR APIs enabled?
- name: dom.vr.webxr.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# W3C draft pointer events
- name: dom.w3c_pointer_events.enabled
type: RelaxedAtomicBool
value: @IS_NOT_ANDROID@
mirror: always
#ifdef XP_WIN
# Control firing WidgetMouseEvent by handling Windows pointer messages or
# mouse messages.
- name: dom.w3c_pointer_events.dispatch_by_pointer_messages
type: bool
value: false
mirror: always
#endif
# If the value is >= 0, it will be used for max touch points in child processes.
- name: dom.maxtouchpoints.testing.value
type: int32_t
value: -1
mirror: always
# If the pref is set to true, pointer events are enabled on GeckoView, but only
# in the case it is using separate child processes.
- name: dom.w3c_pointer_events.multiprocess.android.enabled
type: bool
value: true
mirror: always
# Is support for Navigator.webdriver enabled?
- name: dom.webdriver.enabled
type: bool
value: true
mirror: always
# In case Touch API is enabled, this pref controls whether to support
# ontouch* event handlers, document.createTouch, document.createTouchList and
# document.createEvent("TouchEvent").
- name: dom.w3c_touch_events.legacy_apis.enabled
type: bool
value: @IS_ANDROID@
mirror: always
# Is support for the Web Audio API enabled?
- name: dom.webaudio.enabled
type: bool
value: true
mirror: always
- name: dom.webkitBlink.dirPicker.enabled
type: RelaxedAtomicBool
value: @IS_NOT_ANDROID@
mirror: always
# NOTE: This preference is used in unit tests. If it is removed or its default
# value changes, please update test_sharedMap_var_caches.js accordingly.
- name: dom.webcomponents.shadowdom.report_usage
type: bool
value: false
mirror: always
# Is support for elementInternals enabled?
- name: dom.webcomponents.elementInternals.enabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Is support for the Web GPU API enabled?
- name: dom.webgpu.enable
type: RelaxedAtomicBool
value: false
mirror: always
# Is support for HTMLInputElement.webkitEntries enabled?
- name: dom.webkitBlink.filesystem.enabled
type: bool
value: @IS_NOT_ANDROID@
mirror: always
# Whether the WebMIDI API is enabled
- name: dom.webmidi.enabled
type: bool
value: false
mirror: always
- name: dom.webnotifications.allowinsecure
type: RelaxedAtomicBool
value: false
mirror: always
- name: dom.webnotifications.allowcrossoriginiframe
type: RelaxedAtomicBool
value: false
mirror: always
- name: dom.webnotifications.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: dom.webnotifications.requireuserinteraction
type: RelaxedAtomicBool
value: true
mirror: always
- name: dom.webnotifications.requireinteraction.enabled
type: RelaxedAtomicBool
value: @IS_NIGHTLY_BUILD@
mirror: always
- name: dom.webnotifications.serviceworker.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Is support for Window.event enabled?
- name: dom.window.event.enabled
type: bool
value: true
mirror: always
- name: dom.window.history.async
type: bool
value: true
mirror: always
# Enable the "noreferrer" feature argument for window.open()
- name: dom.window.open.noreferrer.enabled
type: bool
value: true
mirror: always
- name: dom.worker.canceling.timeoutMilliseconds
type: RelaxedAtomicUint32
value: 30000 # 30 seconds
mirror: always
# Is support for compiling DOM worker scripts directly from UTF-8 (without ever
# inflating to UTF-16) enabled?
- name: dom.worker.script_loader.utf8_parsing.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: dom.worker.use_medium_high_event_queue
type: RelaxedAtomicBool
value: true
mirror: always
- name: dom.worklet.enabled
type: bool
value: false
mirror: always
# Enable content type normalization of XHR uploads via MIME Sniffing standard
- name: dom.xhr.standard_content_type_normalization
type: RelaxedAtomicBool
value: true
mirror: always
# When this pref is set, parent documents may consider child iframes have
# loaded while they are still loading.
- name: dom.cross_origin_iframes_loaded_in_background
type: bool
value: false
mirror: always
# WebIDL test prefs.
- name: dom.webidl.test1
type: bool
value: true
mirror: always
- name: dom.webidl.test2
type: bool
value: true
mirror: always
# WebShare API - exposes navigator.share()
- name: dom.webshare.enabled
type: bool
value: false
mirror: always
# WebShare API - allows WebShare without user interaction (for tests only).
- name: dom.webshare.requireinteraction
type: bool
value: true
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "editor"
#---------------------------------------------------------------------------
# Delay to mask last input character in password fields.
# If negative value, to use platform's default behavior.
# If 0, no delay to mask password.
# Otherwise, password fields unmask last input character(s) during specified
# time (in milliseconds).
- name: editor.password.mask_delay
type: int32_t
value: -1
mirror: always
# Set to true when you test mask_delay of password editor. If this is set
# to true, "MozLastInputMasked" is fired when last input characters are
# masked by timeout.
- name: editor.password.testing.mask_delay
type: bool
value: false
mirror: always
# General prefs for editor, indicating whether Gecko-specific editing UI is
# enabled by default. Those UIs are not implemented by any other browsers. So,
# only Firefox users can change some styles with them. This means that Firefox
# users may get unexpected result of some web apps if they assume that users
# cannot change such styles.
- name: editor.resizing.enabled_by_default
type: bool
value: false
mirror: always
- name: editor.inline_table_editing.enabled_by_default
type: bool
value: false
mirror: always
- name: editor.positioning.enabled_by_default
type: bool
value: false
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "extensions."
#---------------------------------------------------------------------------
# Private browsing opt-in is only supported on Firefox desktop.
- name: extensions.allowPrivateBrowsingByDefault
type: bool
value: @IS_ANDROID@
mirror: always
# This pref governs whether we enable content script CSP in extensions.
- name: extensions.content_script_csp.enabled
type: bool
value: false
mirror: always
# This pref governs whether content script CSP is report-only.
- name: extensions.content_script_csp.report_only
type: bool
value: true
mirror: always
# This pref governs whether we run webextensions in a separate process (true)
# or the parent/main process (false)
- name: extensions.webextensions.remote
type: RelaxedAtomicBool
value: false
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "findbar."
#---------------------------------------------------------------------------
- name: findbar.modalHighlight
type: bool
value: false
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "fission."
#---------------------------------------------------------------------------
# Whether to enable Fission.
# Overridden in all.js on RELEASE_OR_BETA in order to add the locked attribute.
- name: fission.autostart
type: bool
value: false
mirror: always
# This pref has no effect within fission windows, it only controls the
# behaviour within non-fission windows. If true, preserve browsing contexts
# between process swaps. Should be set to true in bug 1550571.
- name: fission.preserve_browsing_contexts
type: bool
value: false
mirror: always
# Store the session history in the parent process, and access it over IPC
# from the child processes.
- name: fission.sessionHistoryInParent
type: bool
value: false
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "font."
#---------------------------------------------------------------------------
# A value greater than zero enables font size inflation for
# pan-and-zoom UIs, so that the fonts in a block are at least the size
# that, if a block's width is scaled to match the device's width, the
# fonts in the block are big enough that at most the pref value ems of
# text fit in *the width of the device*.
#
# When both this pref and the next are set, the larger inflation is used.
- name: font.size.inflation.emPerLine
type: uint32_t
value: 0
mirror: always
# A value greater than zero enables font size inflation for
# pan-and-zoom UIs, so that if a block's width is scaled to match the
# device's width, the fonts in a block are at least the given font size.
# The value given is in twips, i.e., 1/20 of a point, or 1/1440 of an inch.
#
# When both this pref and the previous are set, the larger inflation is used.
- name: font.size.inflation.minTwips
type: uint32_t
value: 0
mirror: always
# In products with multi-mode pan-and-zoom and non-pan-and-zoom UIs,
# this pref forces font inflation to always be enabled in all modes.
# That is, any heuristics used to detect pan-and-zoom
# vs. non-pan-and-zoom modes are disabled and all content is treated
# as pan-and-zoom mode wrt font inflation.
#
# This pref has no effect if font inflation is not enabled through
# either of the prefs above. It has no meaning in single-mode UIs.
- name: font.size.inflation.forceEnabled
type: bool
value: false
mirror: always
# In products with multi-mode pan-and-zoom and non-pan-and-zoom UIs,
# this pref disables font inflation in master-process contexts where
# existing heuristics can't be used determine enabled-ness.
#
# This pref has no effect if font inflation is not enabled through
# either of the prefs above. The "forceEnabled" pref above overrides
# this pref.
- name: font.size.inflation.disabledInMasterProcess
type: bool
value: false
mirror: always
# Defines the font size inflation mapping intercept parameter.
#
# Font size inflation computes a minimum font size, m, based on
# other preferences (see font.size.inflation.minTwips and
# font.size.inflation.emPerLine, above) and the width of the
# frame in which the text resides. Using this minimum, a specified
# font size, s, is mapped to an inflated font size, i, using an
# equation that varies depending on the value of the font size
# inflation mapping intercept parameter, P.
#
# If the intercept parameter is negative, then the following mapping
# function is used:
#
# i = m + s
#
# If the intercept parameter is non-negative, then the mapping function
# is a function such that its graph meets the graph of i = s at the
# point where both i and s are (1 + P/2) * m for values of s that are
# large enough. This means that when s=0, i is always equal to m.
- name: font.size.inflation.mappingIntercept
type: int32_t
value: 1
mirror: always
# Since the goal of font size inflation is to avoid having to
# repeatedly scroll side to side to read a block of text, and there are
# a number of page layouts where a relatively small chunk of text is
# better off not being inflated according to the same algorithm we use
# for larger chunks of text, we want a threshold for an amount of text
# that triggers font size inflation. This preference controls that
# threshold.
#
# It controls the threshold used within an *approximation* of the
# number of lines of text we use. In particular, if we assume that
# each character (collapsing collapsible whitespace) has a width the
# same as the em-size of the font (when, normally, it's actually quite
# a bit smaller on average), this preference gives the percentage of a
# number of lines of text we'd need to trigger inflation. This means
# that a percentage of 100 means that we'd need a number of characters
# (we know the font size and the width) equivalent to one line of
# square text (which is actually a lot less than a real line of text).
#
# A value of 0 means there's no character length threshold.
- name: font.size.inflation.lineThreshold
type: uint32_t
value: 400
mirror: always
# This controls the percentage that fonts will be inflated, if font
# size inflation is enabled. Essentially, if we have a specified font
# size, s, and an inflated font size, i, this specifies that the ratio
# i/s * 100 should never exceed the value of this preference. In order
# for this preference to have any effect, its value must be greater
# than 100, since font inflation can never decrease the ratio i/s.
- name: font.size.inflation.maxRatio
type: uint32_t
value: 0
mirror: always
# This setting corresponds to a global text zoom setting affecting
# all content that is not already subject to font size inflation.
# It is interpreted as a percentage value that is applied on top
# of the document's current text zoom setting.
#
# The resulting total zoom factor (text zoom * system font scale)
# will be limited by zoom.minPercent and maxPercent.
- name: font.size.systemFontScale
type: uint32_t
value: 100
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "full-screen-api."
#---------------------------------------------------------------------------
- name: full-screen-api.enabled
type: bool
value: false
mirror: always
- name: full-screen-api.unprefix.enabled
type: RelaxedAtomicBool
value: true
mirror: always
rust: true
- name: full-screen-api.allow-trusted-requests-only
type: bool
value: true
mirror: always
- name: full-screen-api.mouse-event-allow-left-button-only
type: bool
value: true
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "fuzzing.". It's important that these can only be
# checked in fuzzing builds (when FUZZING is defined), otherwise you could
# enable the fuzzing stuff on your regular build which would be bad :)
#---------------------------------------------------------------------------
#ifdef FUZZING
- name: fuzzing.enabled
type: bool
value: false
mirror: always
- name: fuzzing.necko.enabled
type: RelaxedAtomicBool
value: false
mirror: always
#endif
#---------------------------------------------------------------------------
# Prefs starting with "general."
#---------------------------------------------------------------------------
- name: general.aboutConfig.enable
type: bool
value: true
mirror: always
- name: general.smoothScroll
type: RelaxedAtomicBool
value: true
mirror: always
# This pref and general.smoothScroll.stopDecelerationWeighting determine
# the timing function.
- name: general.smoothScroll.currentVelocityWeighting
type: AtomicFloat
value: 0.25
mirror: always
# To connect consecutive scroll events into a continuous flow, the animation's
# duration should be longer than scroll events intervals (or else the scroll
# will stop before the next event arrives - we're guessing the next interval
# by averaging recent intervals).
# This defines how much longer the duration is compared to the events
# interval (percentage).
- name: general.smoothScroll.durationToIntervalRatio
type: RelaxedAtomicInt32
value: 200
mirror: always
- name: general.smoothScroll.lines.durationMaxMS
type: RelaxedAtomicInt32
value: 150
mirror: always
- name: general.smoothScroll.lines.durationMinMS
type: RelaxedAtomicInt32
value: 150
mirror: always
- name: general.smoothScroll.mouseWheel
type: RelaxedAtomicBool
value: true
mirror: always
- name: general.smoothScroll.mouseWheel.durationMaxMS
type: RelaxedAtomicInt32
value: 400
mirror: always
- name: general.smoothScroll.mouseWheel.durationMinMS
type: RelaxedAtomicInt32
value: 200
mirror: always
- name: general.smoothScroll.other.durationMaxMS
type: RelaxedAtomicInt32
value: 150
mirror: always
- name: general.smoothScroll.other.durationMinMS
type: RelaxedAtomicInt32
value: 150
mirror: always
- name: general.smoothScroll.pages
type: RelaxedAtomicBool
value: true
mirror: always
- name: general.smoothScroll.pages.durationMaxMS
type: RelaxedAtomicInt32
value: 150
mirror: always
- name: general.smoothScroll.pages.durationMinMS
type: RelaxedAtomicInt32
value: 150
mirror: always
- name: general.smoothScroll.pixels.durationMaxMS
type: RelaxedAtomicInt32
value: 150
mirror: always
- name: general.smoothScroll.pixels.durationMinMS
type: RelaxedAtomicInt32
value: 150
mirror: always
# This pref and general.smoothScroll.currentVelocityWeighting determine
# the timing function.
- name: general.smoothScroll.stopDecelerationWeighting
type: AtomicFloat
value: 0.4f
mirror: always
# Alternative smooth scroll physics. ("MSD" = Mass-Spring-Damper)
- name: general.smoothScroll.msdPhysics.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: general.smoothScroll.msdPhysics.continuousMotionMaxDeltaMS
type: RelaxedAtomicInt32
value: 120
mirror: always
- name: general.smoothScroll.msdPhysics.motionBeginSpringConstant
type: RelaxedAtomicInt32
value: 1250
mirror: always
- name: general.smoothScroll.msdPhysics.slowdownMinDeltaMS
type: RelaxedAtomicInt32
value: 12
mirror: always
- name: general.smoothScroll.msdPhysics.slowdownMinDeltaRatio
type: AtomicFloat
value: 1.3f
mirror: always
- name: general.smoothScroll.msdPhysics.slowdownSpringConstant
type: RelaxedAtomicInt32
value: 2000
mirror: always
- name: general.smoothScroll.msdPhysics.regularSpringConstant
type: RelaxedAtomicInt32
value: 1000
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "geo."
#---------------------------------------------------------------------------
# Is support for Navigator.geolocation enabled?
- name: geo.enabled
type: bool
value: true
mirror: always
# Time, in milliseconds, to wait for the location provider to spin up.
- name: geo.timeout
type: int32_t
value: 6000
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "gfx."
#---------------------------------------------------------------------------
- name: gfx.allow-texture-direct-mapping
type: bool
value: true
mirror: once
# Allow 24-bit colour when the hardware supports it.
- name: gfx.android.rgb16.force
type: bool
value: false
mirror: once
- name: gfx.apitrace.enabled
type: bool
value: false
mirror: once
# Nb: we ignore this pref on release and beta.
- name: gfx.blocklist.all
type: int32_t
value: 0
mirror: once
# 0x7fff is the maximum supported xlib surface size and is more than enough for canvases.
- name: gfx.canvas.max-size
type: RelaxedAtomicInt32
value: 0x7fff
mirror: always
- name: gfx.canvas.remote
type: RelaxedAtomicBool
value: false
mirror: always
- name: gfx.color_management.enablev4
type: RelaxedAtomicBool
value: false
mirror: always
# 0 = Off, 1 = Full, 2 = Tagged Images Only.
# See eCMSMode in gfx/thebes/gfxPlatform.h.
- name: gfx.color_management.mode
type: RelaxedAtomicInt32
value: 2
mirror: always
# The zero default here should match QCMS_INTENT_DEFAULT from qcms.h
- name: gfx.color_management.rendering_intent
type: RelaxedAtomicInt32
value: 0
mirror: always
- name: gfx.compositor.clearstate
type: RelaxedAtomicBool
value: false
mirror: always
#if defined(MOZ_WIDGET_ANDROID)
# Overrides the glClear color used when the surface origin is not (0, 0)
# Used for drawing a border around the content.
- name: gfx.compositor.override.clear-color.r
type: AtomicFloat
value: 0.0f
mirror: always
- name: gfx.compositor.override.clear-color.g
type: AtomicFloat
value: 0.0f
mirror: always
- name: gfx.compositor.override.clear-color.b
type: AtomicFloat
value: 0.0f
mirror: always
- name: gfx.compositor.override.clear-color.a
type: AtomicFloat
value: 0.0f
mirror: always
#endif # defined(MOZ_WIDGET_ANDROID)
- name: gfx.content.always-paint
type: RelaxedAtomicBool
value: false
mirror: always
# Size in megabytes
- name: gfx.content.skia-font-cache-size
type: int32_t
value: 5
mirror: once
- name: gfx.device-reset.limit
type: int32_t
value: 10
mirror: once
- name: gfx.device-reset.threshold-ms
type: int32_t
value: -1
mirror: once
# Whether to disable the automatic detection and use of direct2d.
- name: gfx.direct2d.disabled
type: bool
value: false
mirror: once
# Whether to attempt to enable Direct2D regardless of automatic detection or
# blacklisting.
- name: gfx.direct2d.force-enabled
type: bool
value: false
mirror: once
# Whether to defer destruction of Direct2D DrawTargets to the paint thread
# when using OMTP.
- name: gfx.direct2d.destroy-dt-on-paintthread
type: RelaxedAtomicBool
value: true
mirror: always
- name: gfx.direct3d11.reuse-decoder-device
type: RelaxedAtomicInt32
value: -1
mirror: always
- name: gfx.direct3d11.allow-keyed-mutex
type: RelaxedAtomicBool
value: true
mirror: always
- name: gfx.direct3d11.use-double-buffering
type: RelaxedAtomicBool
# Prefer flipping between two buffers over copying from our back buffer
# to the OS.
value: true
mirror: always
- name: gfx.direct3d11.enable-debug-layer
type: bool
value: false
mirror: once
- name: gfx.direct3d11.break-on-error
type: bool
value: false
mirror: once
- name: gfx.direct3d11.sleep-on-create-device
type: int32_t
value: 0
mirror: once
# Whether to preserve color bitmap tables in fonts (bypassing OTS).
# Currently these are supported only on platforms where we use Freetype
# to render fonts (Linux/Gtk and Android).
- name: gfx.downloadable_fonts.keep_color_bitmaps
type: RelaxedAtomicBool
value: false
mirror: always
# Whether font sanitization is performed on the main thread or not.
- name: gfx.downloadable_fonts.sanitize_omt
type: RelaxedAtomicBool
value: true
mirror: always
# Whether to validate OpenType variation tables in fonts.
- name: gfx.downloadable_fonts.validate_variation_tables
type: RelaxedAtomicBool
value: true
mirror: always
# Whether OTS validation should be applied to OpenType Layout (OTL) tables.
- name: gfx.downloadable_fonts.otl_validation
type: RelaxedAtomicBool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
- name: gfx.draw-color-bars
type: RelaxedAtomicBool
value: false
mirror: always
- name: gfx.e10s.hide-plugins-for-scroll
type: bool
value: true
mirror: once
- name: gfx.e10s.font-list.shared
type: bool
value: false
mirror: once
# Disable antialiasing of Ahem, for use in tests.
- name: gfx.font_rendering.ahem_antialias_none
type: RelaxedAtomicBool
value: false
mirror: always
#if defined(XP_MACOSX)
# Set to true to revert from HarfBuzz AAT shaping to the old Core Text
# backend.
- name: gfx.font_rendering.coretext.enabled
type: RelaxedAtomicBool
value: false
mirror: always
#endif
- name: gfx.font_rendering.opentype_svg.enabled
type: RelaxedAtomicBool
value: true
mirror: always
rust: true
# Whether to enable LayerScope tool and default listening port.
- name: gfx.layerscope.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: gfx.layerscope.port
type: RelaxedAtomicInt32
value: 23456
mirror: always
# The level of logging:
# - 0: no logging;
# - 1: adds errors;
# - 2: adds warnings;
# - 3 or 4: adds debug logging.
# If you set the value to 4, you will also need to set the environment
# variable MOZ_LOG to gfx:4. See mozilla/Logging.h for details.
- name: gfx.logging.level
type: RelaxedAtomicInt32
value: mozilla::gfx::LOG_DEFAULT
mirror: always
include: mozilla/gfx/LoggingConstants.h
- name: gfx.logging.crash.length
type: uint32_t
value: 16
mirror: once
- name: gfx.logging.painted-pixel-count.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# The maximums here are quite conservative, we can tighten them if problems show up.
- name: gfx.logging.texture-usage.enabled
type: bool
value: false
mirror: once
- name: gfx.logging.peak-texture-usage.enabled
type: bool
value: false
mirror: once
- name: gfx.logging.slow-frames.enabled
type: bool
value: false
mirror: once
# Use gfxPlatform::MaxAllocSize instead of the pref directly.
- name: gfx.max-alloc-size
type: int32_t
value: (int32_t)500000000
mirror: once
do_not_use_directly: true
# Use gfxPlatform::MaxTextureSize instead of the pref directly.
- name: gfx.max-texture-size
type: int32_t
value: (int32_t)32767
mirror: once
do_not_use_directly: true
- name: gfx.offscreencanvas.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: gfx.omta.background-color
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
- name: gfx.partialpresent.force
type: RelaxedAtomicInt32
value: 0
mirror: always
# Log severe performance warnings to the error console and profiles.
# This should be use to quickly find which slow paths are used by test cases.
- name: gfx.perf-warnings.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: gfx.testing.device-fail
type: RelaxedAtomicBool
value: false
mirror: always
- name: gfx.testing.device-reset
type: RelaxedAtomicInt32
value: 0
mirror: always
- name: gfx.text.disable-aa
type: bool
value: false
mirror: once
- name: gfx.text.subpixel-position.force-enabled
type: bool
value: false
mirror: once
- name: gfx.text.subpixel-position.force-disabled
type: bool
value: false
mirror: once
# Disable surface sharing due to issues with compatible FBConfigs on
# NVIDIA drivers as described in bug 1193015.
- name: gfx.use-glx-texture-from-pixmap
type: RelaxedAtomicBool
value: false
mirror: always
- name: gfx.use-iosurface-textures
type: bool
value: false
mirror: once
- name: gfx.use-mutex-on-present
type: bool
value: false
mirror: once
# Use SurfaceTextures as preferred backend for TextureClient/Host.
- name: gfx.use-surfacetexture-textures
type: bool
value: false
mirror: once
- name: gfx.vsync.collect-scroll-transforms
type: RelaxedAtomicBool
value: false
mirror: always
- name: gfx.vsync.compositor.unobserve-count
type: int32_t
value: 10
mirror: once
# We expose two prefs: gfx.webrender.all and gfx.webrender.enabled.
# The first enables WR+additional features, and the second just enables WR.
# For developer convenience, building with --enable-webrender=true or just
# --enable-webrender will set gfx.webrender.enabled to true by default.
#
# We also have a pref gfx.webrender.all.qualified which is not exposed via
# about:config. That pref enables WR but only on qualified hardware. This is
# the pref we'll eventually flip to deploy WebRender to the target population.
- name: gfx.webrender.all
type: bool
value: false
mirror: once
- name: gfx.webrender.enabled
type: bool
value: false
mirror: once
do_not_use_directly: true
- name: gfx.webrender.blob-images
type: RelaxedAtomicBool
value: true
mirror: always
- name: gfx.webrender.blob.paint-flashing
type: RelaxedAtomicBool
value: false
mirror: always
- name: gfx.webrender.dl.dump-parent
type: RelaxedAtomicBool
value: false
mirror: always
- name: gfx.webrender.dl.dump-content
type: RelaxedAtomicBool
value: false
mirror: always
# Also expose a pref to allow users to force-disable WR. This is exposed
# on all channels because WR can be enabled on qualified hardware on all
# channels.
- name: gfx.webrender.force-disabled
type: bool
value: false
mirror: once
- name: gfx.webrender.highlight-painted-layers
type: RelaxedAtomicBool
value: false
mirror: always
- name: gfx.webrender.late-scenebuild-threshold
type: RelaxedAtomicInt32
value: 4
mirror: always
- name: gfx.webrender.max-filter-ops-per-chain
type: RelaxedAtomicUint32
value: 64
mirror: always
- name: gfx.webrender.picture-caching
type: RelaxedAtomicBool
value: true
mirror: always
- name: gfx.webrender.split-render-roots
type: bool
value: false
mirror: once
- name: gfx.webrender.compositor
type: bool
value: false
mirror: once
- name: gfx.webrender.compositor.max_update_rects
type: uint32_t
#ifdef XP_WIN
value: 1
#else
value: 0
#endif
mirror: once
- name: gfx.webrender.max-partial-present-rects
type: uint32_t
value: 0
mirror: once
- name: gfx.webrender.enable-gpu-markers
type: bool
#ifdef DEBUG
value: true
#else
value: false
#endif
mirror: once
#ifdef NIGHTLY_BUILD
# Keep this pref hidden on non-nightly builds to avoid people accidentally
# turning it on.
- name: gfx.webrender.start-debug-server
type: RelaxedAtomicBool
value: false
mirror: always
#endif
#ifdef XP_WIN
# Enables display of performance debugging counters when DirectComposition
# is used.
# Performance counters are displayed on the top-right corner of the screen.
- name: gfx.webrender.debug.dcomp-counter
type: RelaxedAtomicBool
value: false
mirror: always
# Enables highlighting redraw regions of DCompositionVisual
- name: gfx.webrender.debug.dcomp-redraw-regions
type: RelaxedAtomicBool
value: false
mirror: always
#endif
# Use vsync events generated by hardware
- name: gfx.work-around-driver-bugs
type: bool
value: true
mirror: once
- name: gfx.ycbcr.accurate-conversion
type: RelaxedAtomicBool
value: false
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "gl." (OpenGL)
#---------------------------------------------------------------------------
- name: gl.allow-high-power
type: RelaxedAtomicBool
value: true
mirror: always
- name: gl.ignore-dx-interop2-blacklist
type: RelaxedAtomicBool
value: false
mirror: always
#if defined(XP_MACOSX)
- name: gl.multithreaded
type: RelaxedAtomicBool
value: true
mirror: always
#endif
- name: gl.require-hardware
type: RelaxedAtomicBool
value: false
mirror: always
- name: gl.use-tls-is-current
type: RelaxedAtomicInt32
value: 0
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "html5."
#---------------------------------------------------------------------------
# Toggle which thread the HTML5 parser uses for stream parsing.
- name: html5.offmainthread
type: bool
value: true
mirror: always
# Time in milliseconds between the time a network buffer is seen and the timer
# firing when the timer hasn't fired previously in this parse in the
# off-the-main-thread HTML5 parser.
- name: html5.flushtimer.initialdelay
type: RelaxedAtomicInt32
value: 16
mirror: always
# Time in milliseconds between the time a network buffer is seen and the timer
# firing when the timer has already fired previously in this parse.
- name: html5.flushtimer.subsequentdelay
type: RelaxedAtomicInt32
value: 16
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "idle_period."
#---------------------------------------------------------------------------
- name: idle_period.min
type: uint32_t
value: 3
mirror: always
- name: idle_period.during_page_load.min
type: uint32_t
value: 12
mirror: always
- name: idle_period.cross_process_scheduling
type: RelaxedAtomicBool
value: true
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "image."
#---------------------------------------------------------------------------
# The maximum size (in kB) that the aggregate frames of an animation can use
# before it starts to discard already displayed frames and redecode them as
# necessary.
- name: image.animated.decode-on-demand.threshold-kb
type: RelaxedAtomicUint32
value: 20*1024
mirror: always
# The minimum number of frames we want to have buffered ahead of an
# animation's currently displayed frame.
- name: image.animated.decode-on-demand.batch-size
type: RelaxedAtomicUint32
value: 6
mirror: always
# Whether we should recycle already displayed frames instead of discarding
# them. This saves on the allocation itself, and may be able to reuse the
# contents as well. Only applies if generating full frames.
- name: image.animated.decode-on-demand.recycle
type: bool
value: true
mirror: once
# Resume an animated image from the last displayed frame rather than
# advancing when out of view.
- name: image.animated.resume-from-last-displayed
type: RelaxedAtomicBool
value: true
mirror: always
# Maximum number of surfaces for an image before entering "factor of 2" mode.
# This in addition to the number of "native" sizes of an image. A native size
# is a size for which we can decode a frame without up or downscaling. Most
# images only have 1, but some (i.e. ICOs) may have multiple frames for the
# same data at different sizes.
- name: image.cache.factor2.threshold-surfaces
type: RelaxedAtomicInt32
value: 4
mirror: always
# Maximum size of a surface in KB we are willing to produce when rasterizing
# an SVG.
- name: image.cache.max-rasterized-svg-threshold-kb
type: RelaxedAtomicInt32
value: 200*1024
mirror: always
# The maximum size, in bytes, of the decoded images we cache.
- name: image.cache.size
type: int32_t
value: 5*1024*1024
mirror: once
# A weight, from 0-1000, to place on time when comparing to size.
# Size is given a weight of 1000 - timeweight.
- name: image.cache.timeweight
type: int32_t
value: 500
mirror: once
# Decode all images automatically on load, ignoring our normal heuristics.
- name: image.decode-immediately.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# Whether we attempt to downscale images during decoding.
- name: image.downscale-during-decode.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# The threshold for inferring that changes to an <img> element's |src|
# attribute by JavaScript represent an animation, in milliseconds. If the |src|
# attribute is changing more frequently than this value, then we enter a
# special "animation mode" which is designed to eliminate flicker. Set to 0 to
# disable.
- name: image.infer-src-animation.threshold-ms
type: RelaxedAtomicUint32
value: 2000
mirror: always
# Whether the network request priority should be adjusted according
# the layout and view frame position of each particular image.
- name: image.layout_network_priority
type: RelaxedAtomicBool
value: true
mirror: always
# Chunk size for calls to the image decoders.
- name: image.mem.decode_bytes_at_a_time
type: uint32_t
value: 16384
mirror: once
# Discards inactive image frames and re-decodes them on demand from
# compressed data.
- name: image.mem.discardable
type: RelaxedAtomicBool
value: true
mirror: always
# Discards inactive image frames of _animated_ images and re-decodes them on
# demand from compressed data. Has no effect if image.mem.discardable is false.
- name: image.mem.animated.discardable
type: bool
value: true
mirror: once
# Whether the heap should be used for frames from animated images. On Android,
# volatile memory keeps file handles open for each buffer.
- name: image.mem.animated.use_heap
type: RelaxedAtomicBool
value: @IS_ANDROID@
mirror: always
# Enable extra information for debugging in the image memory reports.
- name: image.mem.debug-reporting
type: RelaxedAtomicBool
value: false
mirror: always
# Decodes images into shared memory to allow direct use in separate
# rendering processes. Only applicable with WebRender.
- name: image.mem.shared
type: RelaxedAtomicBool
value: true
mirror: always
# How much of the data in the surface cache is discarded when we get a memory
# pressure notification, as a fraction. The discard factor is interpreted as a
# reciprocal, so a discard factor of 1 means to discard everything in the
# surface cache on memory pressure, a discard factor of 2 means to discard half
# of the data, and so forth. The default should be a good balance for desktop
# and laptop systems, where we never discard visible images.
- name: image.mem.surfacecache.discard_factor
type: uint32_t
value: 1
mirror: once
# Maximum size for the surface cache, in kilobytes.
- name: image.mem.surfacecache.max_size_kb
type: uint32_t
value: 2024 * 1024
mirror: once
# Minimum timeout for expiring unused images from the surface cache, in
# milliseconds. This controls how long we store cached temporary surfaces.
- name: image.mem.surfacecache.min_expiration_ms
type: uint32_t
value: 60*1000
mirror: once
# The surface cache's size, within the constraints of the maximum size set
# above, is determined as a fraction of main memory size. The size factor is
# interpreted as a reciprocal, so a size factor of 4 means to use no more than
# 1/4 of main memory. The default should be a good balance for most systems.
- name: image.mem.surfacecache.size_factor
type: uint32_t
value: 4
mirror: once
# Minimum buffer size in KB before using volatile memory over the heap.
- name: image.mem.volatile.min_threshold_kb
type: RelaxedAtomicInt32
#if defined(ANDROID)
# On Android, volatile memory keeps file handles open for each buffer.
value: 100
#else
value: -1
#endif
mirror: always
# How long in ms before we should start shutting down idle decoder threads.
- name: image.multithreaded_decoding.idle_timeout
type: int32_t
value: 600000
mirror: once
# How many threads we'll use for multithreaded decoding. If < 0, will be
# automatically determined based on the system's number of cores.
- name: image.multithreaded_decoding.limit
type: int32_t
value: -1
mirror: once
# Whether we attempt to decode WebP images or not.
- name: image.webp.enabled
type: RelaxedAtomicBool
value: true
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "intl."
#---------------------------------------------------------------------------
# Whether ISO-2022-JP is a permitted content-based encoding detection
# outcome.
- name: intl.charset.detector.iso2022jp.allowed
type: bool
value: true
mirror: always
- name: intl.charset.fallback.tld
type: bool
value: true
mirror: always
# If true, dispatch the keydown and keyup events on any web apps even during
# composition.
- name: intl.ime.hack.on_any_apps.fire_key_events_for_composition
type: bool
#ifdef MOZ_WIDGET_ANDROID
value: @IS_EARLY_BETA_OR_EARLIER@
#else
value: false
#endif
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "javascript."
#---------------------------------------------------------------------------
- name: javascript.options.compact_on_user_inactive
type: bool
value: true
mirror: always
# The default amount of time to wait from the user being idle to starting a
# shrinking GC. Measured in milliseconds.
- name: javascript.options.compact_on_user_inactive_delay
type: uint32_t
#ifdef NIGHTLY_BUILD
value: 15000
#else
value: 300000
#endif
mirror: always
- name: javascript.options.experimental.fields
type: RelaxedAtomicBool
value: true
mirror: always
- name: javascript.options.experimental.await_fix
type: RelaxedAtomicBool
value: true
mirror: always
# The amount of time we wait between a request to GC (due to leaving a page) and doing the actual GC, in ms.
- name: javascript.options.gc_delay
type: uint32_t
value: 4000
mirror: always
# The amount of time we wait from the first request to GC to actually doing the first GC, in ms.
- name: javascript.options.gc_delay.first
type: uint32_t
value: 10000
mirror: always
# Duration of the dom events full gc delay, in ms.
- name: javascript.options.gc_delay.full
type: uint32_t
value: 60000
mirror: always
# Maximum amount of time that should elapse between incremental GC slices, in ms.
- name: javascript.options.gc_delay.interslice
type: uint32_t
value: 100
mirror: always
# nsJSEnvironmentObserver observes the memory-pressure notifications and
# forces a garbage collection and cycle collection when it happens, if the
# appropriate pref is set.
- name: javascript.options.gc_on_memory_pressure
type: bool
# Disable the JS engine's GC on memory pressure, since we do one in the
# mobile browser (bug 669346).
# XXX: this value possibly should be changed, or the pref removed entirely.
# See bug 1450787.
value: @IS_NOT_ANDROID@
mirror: always
- name: javascript.options.mem.log
type: bool
value: false
mirror: always
- name: javascript.options.mem.notify
type: bool
value: false
mirror: always
# Streams API.
- name: javascript.options.streams
type: RelaxedAtomicBool
value: true
mirror: always
# Writable Streams API. (The pref above must also be set to expose this.)
#
# Writable streams are still EXTRAORDINARILY BETA and it is well-known that
# things are likely pretty broken if you poke much at all, so if you flip this
# preference, don't report bugs against it just yet.
- name: javascript.options.writable_streams
type: RelaxedAtomicBool
value: false
mirror: always
- name: javascript.options.main_thread_stack_quota_cap
type: uint32_t
#if defined(MOZ_ASAN)
value: 6 * 1024 * 1024
#else
value: 2 * 1024 * 1024
#endif
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "keyword."
#---------------------------------------------------------------------------
- name: keyword.enabled
type: bool
value: false
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "layers."
#---------------------------------------------------------------------------
# Whether to disable acceleration for all widgets.
- name: layers.acceleration.disabled
type: bool
value: false
mirror: once
do_not_use_directly: true
# Instead, use gfxConfig::IsEnabled(Feature::HW_COMPOSITING).
- name: layers.acceleration.draw-fps
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.acceleration.draw-fps.print-histogram
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.acceleration.draw-fps.write-to-file
type: RelaxedAtomicBool
value: false
mirror: always
# Whether to force acceleration on, ignoring blacklists.
# bug 838603 -- on Android, accidentally blacklisting OpenGL layers
# means a startup crash for everyone.
# Temporarily force-enable GL compositing. This is default-disabled
# deep within the bowels of the widgetry system. Remove me when GL
# compositing isn't default disabled in widget/android.
- name: layers.acceleration.force-enabled
type: bool
value: @IS_ANDROID@
mirror: once
do_not_use_directly: true
- name: layers.advanced.basic-layer.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# Whether we allow AMD switchable graphics.
- name: layers.amd-switchable-gfx.enabled
type: bool
value: true
mirror: once
# Whether to use async panning and zooming.
- name: layers.async-pan-zoom.enabled
type: bool
value: true
mirror: once
do_not_use_directly: true
# Preference that when switched at runtime will run a series of benchmarks
# and output the result to stderr.
- name: layers.bench.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.bufferrotation.enabled
type: bool
value: true
mirror: once
- name: layers.child-process-shutdown
type: RelaxedAtomicBool
value: true
mirror: always
- name: layers.componentalpha.enabled
type: bool
#ifdef MOZ_GFX_OPTIMIZE_MOBILE
# Nb: we ignore this pref if MOZ_GFX_OPTIMIZE_MOBILE is defined, as if this
# pref was always false. But we go to the effort of setting it to false so
# that telemetry's reporting of the pref value is more likely to reflect what
# the code is doing.
value: false
#else
value: true
#endif
mirror: once
do_not_use_directly: true
- name: layers.d3d11.force-warp
type: bool
value: false
mirror: once
- name: layers.d3d11.enable-blacklist
type: bool
value: true
mirror: once
# Enable DEAA antialiasing for transformed layers in the compositor.
- name: layers.deaa.enabled
type: RelaxedAtomicBool
#if defined(MOZ_WIDGET_ANDROID)
value: false
#else
value: true
#endif
mirror: always
- name: layers.draw-bigimage-borders
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.draw-borders
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.draw-tile-borders
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.draw-layer-info
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.dump
type: RelaxedAtomicBool
value: false
mirror: always
# If we're dumping layers, also dump the texture data
- name: layers.dump-texture
type: RelaxedAtomicBool
value: false
mirror: always
#ifdef MOZ_DUMP_PAINTING
- name: layers.dump-decision
type: RelaxedAtomicBool
value: false
mirror: always
#endif
- name: layers.dump-client-layers
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.dump-host-layers
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.compositing-tiles.width
type: RelaxedAtomicInt32
value: 1024
mirror: always
- name: layers.compositing-tiles.height
type: RelaxedAtomicInt32
value: 1024
mirror: always
# 0 is "no change" for contrast, positive values increase it, negative values
# decrease it until we hit mid gray at -1 contrast, after that it gets weird.
- name: layers.effect.contrast
type: AtomicFloat
value: 0.0f
mirror: always
- name: layers.effect.grayscale
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.effect.invert
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.enable-tiles
type: bool
#if defined(XP_MACOSX) || defined (XP_OPENBSD)
value: true
#else
value: false
#endif
mirror: once
- name: layers.enable-tiles-if-skia-pomtp
type: bool
#if defined(XP_WIN)
value: true
#else
value: false
#endif
mirror: once
- name: layers.flash-borders
type: RelaxedAtomicBool
value: false
mirror: always
# Force all possible layers to be always active layers.
- name: layers.force-active
type: bool
value: false
mirror: always
- name: layers.force-shmem-tiles
type: bool
value: false
mirror: once
- name: layers.draw-mask-debug
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.force-synchronous-resize
type: RelaxedAtomicBool
value: true
mirror: always
# Whether to enable arbitrary layer geometry for OpenGL compositor.
- name: layers.geometry.opengl.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Whether to enable arbitrary layer geometry for Basic compositor.
- name: layers.geometry.basic.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Whether to enable arbitrary layer geometry for DirectX compositor.
- name: layers.geometry.d3d11.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: layers.gpu-process.allow-software
type: bool
#if defined(XP_WIN)
value: true
#else
value: false
#endif
mirror: once
- name: layers.gpu-process.enabled
type: bool
#if defined(XP_WIN) || defined(MOZ_WIDGET_GTK)
value: true
#else
value: false
#endif
mirror: once
- name: layers.gpu-process.force-enabled
type: bool
value: false
mirror: once
- name: layers.gpu-process.ipc_reply_timeout_ms
type: int32_t
value: 10000
mirror: once
- name: layers.gpu-process.max_restarts
type: RelaxedAtomicInt32
#if defined(XP_WIN) || defined(MOZ_WIDGET_GTK)
#if defined(NIGHTLY_BUILD)
value: 3
#else
value: 1
#endif
#else
value: 1
#endif
mirror: always
# Note: This pref will only be used if it is less than layers.gpu-process.max_restarts.
- name: layers.gpu-process.max_restarts_with_decoder
type: RelaxedAtomicInt32
value: 0
mirror: always
- name: layers.gpu-process.startup_timeout_ms
type: int32_t
value: 5000
mirror: once
- name: layers.low-precision-buffer
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.low-precision-opacity
type: AtomicFloat
value: 1.0f
mirror: always
- name: layers.low-precision-resolution
type: AtomicFloat
value: 0.25f
mirror: always
# Max number of layers per container. See Overwrite in mobile prefs.
- name: layers.max-active
type: RelaxedAtomicInt32
value: -1
mirror: always
- name: layers.mlgpu.enabled
type: bool
#if defined(XP_WIN)
value: true
#else
value: false
#endif
mirror: once
do_not_use_directly: true
- name: layers.mlgpu.enable-buffer-cache
type: bool
value: true
mirror: once
- name: layers.mlgpu.enable-buffer-sharing
type: bool
value: true
mirror: once
- name: layers.mlgpu.enable-clear-view
type: bool
value: true
mirror: once
- name: layers.mlgpu.enable-cpu-occlusion
type: bool
value: true
mirror: once
- name: layers.mlgpu.enable-depth-buffer
type: bool
value: false
mirror: once
- name: layers.mlgpu.enable-invalidation
type: RelaxedAtomicBool
value: true
mirror: always
# Both this and the master "enabled" pref must be on to use Advanced Layers
# on Windows 7.
- name: layers.mlgpu.enable-on-windows7
type: bool
#if defined(XP_WIN)
value: true
#else
value: false
#endif
mirror: once
# Whether to animate simple opacity and transforms on the compositor.
- name: layers.offmainthreadcomposition.async-animations
type: bool
value: true
mirror: always
# Whether to log information about off main thread animations to stderr.
- name: layers.offmainthreadcomposition.log-animations
type: bool
value: false
mirror: always
- name: layers.offmainthreadcomposition.force-disabled
type: bool
value: false
mirror: once
# Compositor target frame rate. NOTE: If vsync is enabled the compositor
# frame rate will still be capped.
# -1 -> default (match layout.frame_rate or 60 FPS)
# 0 -> full-tilt mode: Recomposite even if not transaction occured.
- name: layers.offmainthreadcomposition.frame-rate
type: RelaxedAtomicInt32
value: -1
mirror: always
- name: layers.omtp.capture-limit
type: uint32_t
value: 25 * 1024 * 1024
mirror: once
- name: layers.omtp.dump-capture
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.omtp.paint-workers
type: int32_t
value: -1
mirror: once
- name: layers.omtp.release-capture-on-main-thread
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.orientation.sync.timeout
type: RelaxedAtomicUint32
value: (uint32_t)0
mirror: always
#ifdef XP_WIN
- name: layers.prefer-opengl
type: bool
value: false
mirror: once
#endif
- name: layers.progressive-paint
type: RelaxedAtomicBool
value: false
mirror: always
# Copy-on-write canvas.
- name: layers.shared-buffer-provider.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: layers.single-tile.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# We allow for configurable and rectangular tile size to avoid wasting memory
# on devices whose screen size does not align nicely to the default tile size.
# Although layers can be any size, they are often the same size as the screen,
# especially for width.
- name: layers.tile-width
type: int32_t
value: 512
mirror: once
- name: layers.tile-height
type: int32_t
value: 512
mirror: once
- name: layers.tile-initial-pool-size
type: uint32_t
value: (uint32_t)50
mirror: once
- name: layers.tile-pool-unused-size
type: uint32_t
value: (uint32_t)10
mirror: once
- name: layers.tile-pool-shrink-timeout
type: uint32_t
value: (uint32_t)50
mirror: once
- name: layers.tile-pool-clear-timeout
type: uint32_t
value: (uint32_t)5000
mirror: once
# If this is set the tile size will only be treated as a suggestion.
# On B2G we will round this to the stride of the underlying allocation.
# On any platform we may later use the screen size and ignore
# tile-width/tile-height entirely. Its recommended to turn this off
# if you change the tile size.
- name: layers.tiles.adjust
type: bool
value: true
mirror: once
- name: layers.tiles.edge-padding
type: bool
value: @IS_ANDROID@
mirror: once
- name: layers.tiles.fade-in.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: layers.tiles.fade-in.duration-ms
type: RelaxedAtomicUint32
value: 250
mirror: always
- name: layers.tiles.retain-back-buffer
type: RelaxedAtomicBool
value: true
mirror: always
- name: layers.transaction.warning-ms
type: RelaxedAtomicUint32
value: 200
mirror: always
- name: layers.uniformity-info
type: bool
value: false
mirror: once
- name: layers.use-image-offscreen-surfaces
type: bool
value: true
mirror: once
#---------------------------------------------------------------------------
# Prefs starting with "layout."
#---------------------------------------------------------------------------
# Debug-only pref to force enable the AccessibleCaret. If you want to
# control AccessibleCaret by mouse, you'll need to set
# "layout.accessiblecaret.hide_carets_for_mouse_input" to false.
- name: layout.accessiblecaret.enabled
type: bool
value: false
mirror: always
# Enable the accessible caret on platforms/devices
# that we detect have touch support. Note that this pref is an
# additional way to enable the accessible carets, rather than
# overriding the layout.accessiblecaret.enabled pref.
- name: layout.accessiblecaret.enabled_on_touch
type: bool
value: true
mirror: always
# By default, carets become tilt only when they are overlapping.
- name: layout.accessiblecaret.always_tilt
type: bool
value: false
mirror: always
# Show caret in cursor mode when long tapping on an empty content. This
# also changes the default update behavior in cursor mode, which is based
# on the emptiness of the content, into something more heuristic. See
# AccessibleCaretManager::UpdateCaretsForCursorMode() for the details.
- name: layout.accessiblecaret.caret_shown_when_long_tapping_on_empty_content
type: bool
value: false
mirror: always
# 0 = by default, always hide carets for selection changes due to JS calls.
# 1 = update any visible carets for selection changes due to JS calls,
# but don't show carets if carets are hidden.
# 2 = always show carets for selection changes due to JS calls.
- name: layout.accessiblecaret.script_change_update_mode
type: int32_t
value: 0
mirror: always
# Allow one caret to be dragged across the other caret without any limitation.
# This matches the built-in convention for all desktop platforms.
- name: layout.accessiblecaret.allow_dragging_across_other_caret
type: bool
value: true
mirror: always
# Optionally provide haptic feedback on long-press selection events.
- name: layout.accessiblecaret.hapticfeedback
type: bool
value: false
mirror: always
# Smart phone-number selection on long-press is not enabled by default.
- name: layout.accessiblecaret.extend_selection_for_phone_number
type: bool
value: false
mirror: always
# Keep the accessible carets hidden when the user is using mouse input (as
# opposed to touch/pen/etc.).
- name: layout.accessiblecaret.hide_carets_for_mouse_input
type: bool
value: true
mirror: always
# CSS attributes (width, height, margin-left) of the AccessibleCaret in CSS
# pixels.
- name: layout.accessiblecaret.width
type: float
value: 34.0f
mirror: always
- name: layout.accessiblecaret.height
type: float
value: 36.0f
mirror: always
- name: layout.accessiblecaret.margin-left
type: float
value: -18.5f
mirror: always
# Simulate long tap events to select words. Mainly used in manual testing
# with mouse.
- name: layout.accessiblecaret.use_long_tap_injector
type: bool
value: false
mirror: always
# Whether we should layerize all animated images (if otherwise possible).
- name: layout.animated-image-layers.enabled
type: bool
value: false
mirror: always
# One of several prefs affecting the maximum area to pre-render when animating
# a large element on the compositor.
- name: layout.animation.prerender.partial
type: RelaxedAtomicBool
value: false
mirror: always
# One of several prefs affecting the maximum area to pre-render when animating
# a large element on the compositor.
- name: layout.animation.prerender.viewport-ratio-limit-x
type: AtomicFloat
value: 1.125f
mirror: always
# One of several prefs affecting the maximum area to pre-render when animating
# a large element on the compositor.
- name: layout.animation.prerender.viewport-ratio-limit-y
type: AtomicFloat
value: 1.125f
mirror: always
# One of several prefs affecting the maximum area to pre-render when animating
# a large element on the compositor.
- name: layout.animation.prerender.absolute-limit-x
type: RelaxedAtomicUint32
value: 4096
mirror: always
# One of several prefs affecting the maximum area to pre-render when animating
# a large element on the compositor.
- name: layout.animation.prerender.absolute-limit-y
type: RelaxedAtomicUint32
value: 4096
mirror: always
# Whether we get notified of history queries for visited even if unvisited.
- name: layout.css.notify-of-unvisited
type: RelaxedAtomicBool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Whether we always restyle / repaint as a result of a visited query
- name: layout.css.always-repaint-on-unvisited
type: RelaxedAtomicBool
value: false
mirror: always
# Make `zoom` a `transform` + `transform-origin` alias.
- name: layout.css.zoom-transform-hack.enabled
type: RelaxedAtomicBool
value: @IS_NIGHTLY_BUILD@
mirror: always
rust: true
# Allow <number> and <number>/<number> both for <aspect-ratio>
# https://github.com/w3c/csswg-drafts/issues/3757
- name: layout.css.aspect-ratio-number.enabled
type: RelaxedAtomicBool
value: false
mirror: always
rust: true
# Is the codepath for using cached scrollbar styles enabled?
- name: layout.css.cached-scrollbar-styles.enabled
type: bool
value: true
mirror: always
# Is path() supported in clip-path?
- name: layout.css.clip-path-path.enabled
type: RelaxedAtomicBool
value: true
mirror: always
rust: true
# Set the number of device pixels per CSS pixel. A value <= 0 means choose
# automatically based on user settings for the platform (e.g., "UI scale factor"
# on Mac). A positive value is used as-is. This effectively controls the size
# of a CSS "px". This is only used for windows on the screen, not for printing.
- name: layout.css.devPixelsPerPx
type: AtomicFloat
value: -1.0f
mirror: always
# text underline offset
- name: layout.css.text-underline-offset.enabled
type: bool
value: true
mirror: always
# text decoration thickness
- name: layout.css.text-decoration-thickness.enabled
type: bool
value: true
mirror: always
# text decoration skip ink
- name: layout.css.text-decoration-skip-ink.enabled
type: bool
value: true
mirror: always
# Is support for CSS column-span enabled?
- name: layout.css.column-span.enabled
type: bool
value: true
mirror: always
# Is support for CSS backdrop-filter enabled?
- name: layout.css.backdrop-filter.enabled
type: bool
value: false
mirror: always
# Is support for CSS contain enabled?
- name: layout.css.contain.enabled
type: bool
value: true
mirror: always
# Should stray control characters be rendered visibly?
- name: layout.css.control-characters.visible
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
# Is support for GeometryUtils.convert*FromNode enabled?
- name: layout.css.convertFromNode.enabled
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
# Is support for DOMMatrix enabled?
- name: layout.css.DOMMatrix.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Is support for DOMQuad enabled?
- name: layout.css.DOMQuad.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Is support for DOMPoint enabled?
- name: layout.css.DOMPoint.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Are we emulating -moz-{inline}-box layout using CSS flexbox?
- name: layout.css.emulate-moz-box-with-flex
type: bool
value: false
mirror: always
# Is support for the font-display @font-face descriptor enabled?
- name: layout.css.font-display.enabled
type: RelaxedAtomicBool
value: true
mirror: always
rust: true
# Is support for document.fonts enabled?
- name: layout.css.font-loading-api.enabled
type: bool
value: true
mirror: always
# Is support for variation fonts enabled?
- name: layout.css.font-variations.enabled
type: RelaxedAtomicBool
value: true
mirror: always
rust: true
# Is support for GeometryUtils.getBoxQuads enabled?
- name: layout.css.getBoxQuads.enabled
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
# Is support for CSS "grid-template-{columns,rows}: subgrid X" enabled?
- name: layout.css.grid-template-subgrid-value.enabled
type: RelaxedAtomicBool
value: true
mirror: always
rust: true
# Is support for CSS individual transform enabled?
- name: layout.css.individual-transform.enabled
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
# Is support for CSS initial-letter property enabled?
- name: layout.css.initial-letter.enabled
type: bool
value: false
mirror: always
# Pref to control whether line-height: -moz-block-height is exposed to content.
- name: layout.css.line-height-moz-block-height.content.enabled
type: RelaxedAtomicBool
value: false
mirror: always
rust: true
# Is support for motion-path enabled?
- name: layout.css.motion-path.enabled
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
# Expose the media query -moz-touch-enabled to web content.
- name: layout.css.moz-touch-enabled.enabled
type: RelaxedAtomicBool
value: @IS_NOT_NIGHTLY_BUILD@
mirror: always
rust: true
# Pref to control whether the ::marker property restrictions defined in [1]
# apply.
#
# [1]: https://drafts.csswg.org/css-pseudo-4/#selectordef-marker
- name: layout.css.marker.restricted
type: RelaxedAtomicBool
value: true
mirror: always
rust: true
# Pref to control whether @-moz-document rules are enabled in content pages.
- name: layout.css.moz-document.content.enabled
type: RelaxedAtomicBool
value: false
mirror: always
rust: true
# Pref to control whether @-moz-document url-prefix() is parsed in content
# pages. Only effective when layout.css.moz-document.content.enabled is false.
- name: layout.css.moz-document.url-prefix-hack.enabled
type: RelaxedAtomicBool
#ifdef EARLY_BETA_OR_EARLIER
value: false
#else
value: true
#endif
mirror: always
rust: true
# Whether the offset-* logical property aliases are enabled.
- name: layout.css.offset-logical-properties.enabled
type: bool
value: false
mirror: always
# Is -moz-osx-font-smoothing enabled? (Only supported in OSX builds)
- name: layout.css.osx-font-smoothing.enabled
type: bool
#if defined(XP_MACOSX)
value: true
#else
value: false
#endif
mirror: always
# Is support for CSS overflow-clip-box enabled for non-UA sheets?
- name: layout.css.overflow-clip-box.enabled
type: bool
value: false
mirror: always
# Is support for overscroll-behavior enabled?
- name: layout.css.overscroll-behavior.enabled
type: bool
value: true
mirror: always
- name: layout.css.overflow-logical.enabled
type: bool
value: true
mirror: always
# Is parallel CSS parsing enabled?
- name: layout.css.parsing.parallel
type: bool
value: true
mirror: always
# Is support for -moz-prefixed animation properties enabled?
- name: layout.css.prefixes.animations
type: bool
value: true
mirror: always
# Is support for -moz-border-image enabled?
- name: layout.css.prefixes.border-image
type: bool
value: true
mirror: always
# Is support for -moz-box-sizing enabled?
- name: layout.css.prefixes.box-sizing
type: bool
value: true
mirror: always
# Is support for -moz-prefixed font feature properties enabled?
- name: layout.css.prefixes.font-features
type: bool
value: true
mirror: always
# Is support for -moz-prefixed transform properties enabled?
- name: layout.css.prefixes.transforms
type: bool
value: true
mirror: always
# Is support for -moz-prefixed transition properties enabled?
- name: layout.css.prefixes.transitions
type: bool
value: true
mirror: always
# Is CSS error reporting enabled?
- name: layout.css.report_errors
type: bool
value: true
mirror: always
- name: layout.css.resizeobserver.enabled
type: bool
value: true
mirror: always
# Are inter-character ruby annotations enabled?
- name: layout.css.ruby.intercharacter.enabled
type: bool
value: false
mirror: always
- name: layout.css.scroll-behavior.damping-ratio
type: AtomicFloat
value: 1.0f
mirror: always
# Is support for scrollbar-color property enabled?
- name: layout.css.scrollbar-color.enabled
type: bool
value: true
mirror: always
# Is support for scrollbar-width property enabled?
- name: layout.css.scrollbar-width.enabled
type: bool
value: true
mirror: always
- name: layout.css.supports-selector.enabled
type: RelaxedAtomicBool
value: true
mirror: always
rust: true
# Is CSSOM-View scroll-behavior and its MSD smooth scrolling enabled?
- name: layout.css.scroll-behavior.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Tuning of the smooth scroll motion used by CSSOM-View scroll-behavior.
# Spring-constant controls the strength of the simulated MSD
# (Mass-Spring-Damper).
- name: layout.css.scroll-behavior.spring-constant
type: AtomicFloat
value: 250.0f
mirror: always
# When selecting the snap point for CSS scroll snapping, the velocity of the
# scroll frame is clamped to this speed, in CSS pixels / s.
- name: layout.css.scroll-snap.prediction-max-velocity
type: RelaxedAtomicInt32
value: 2000
mirror: always
# When selecting the snap point for CSS scroll snapping, the velocity of the
# scroll frame is integrated over this duration, in seconds. The snap point
# best suited for this position is selected, enabling the user to perform fling
# gestures.
- name: layout.css.scroll-snap.prediction-sensitivity
type: AtomicFloat
value: 0.750f
mirror: always
# Set the threshold distance in CSS pixels below which scrolling will snap to
# an edge, when scroll snapping is set to "proximity".
- name: layout.css.scroll-snap.proximity-threshold
type: RelaxedAtomicInt32
value: 200
mirror: always
# Is steps(jump-*) supported in easing functions?
- name: layout.css.step-position-jump.enabled
type: RelaxedAtomicBool
value: true
mirror: always
rust: true
# W3C touch-action css property (related to touch and pointer events)
# Note that we turn this on even on platforms/configurations where touch
# events are not supported (e.g. OS X, or Windows with e10s disabled). For
# those platforms we don't handle touch events anyway so it's conceptually
# a no-op.
- name: layout.css.touch_action.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Does arbitrary ::-webkit-* pseudo-element parsed?
- name: layout.css.unknown-webkit-pseudo-element
type: RelaxedAtomicBool
value: true
mirror: always
rust: true
# Are counters for implemented CSS properties enabled?
- name: layout.css.use-counters.enabled
type: bool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
# Are counters for unimplemented CSS properties enabled?
- name: layout.css.use-counters-unimplemented.enabled
type: RelaxedAtomicBool
value: @IS_NOT_RELEASE_OR_BETA@
mirror: always
rust: true
# Should the :visited selector ever match (otherwise :link matches instead)?
- name: layout.css.visited_links_enabled
type: bool
value: true
mirror: always
# Is the '-webkit-appearance' alias for '-moz-appearance' enabled?
- name: layout.css.webkit-appearance.enabled
type: bool
value: true
mirror: always
- name: layout.css.xul-display-values.content.enabled
type: RelaxedAtomicBool
value: false
mirror: always
rust: true
# Pref to control whether display: -moz-box and display: -moz-inline-box are
# parsed in content pages.
- name: layout.css.xul-box-display-values.content.enabled
type: RelaxedAtomicBool
value: false
mirror: always
rust: true
# Pref to control whether display: -moz-box and display: -moz-inline-box are
# "blockified" to "-moz-box" (rather than to "block")
- name: layout.css.xul-box-display-values.survive-blockification.enabled
type: RelaxedAtomicBool
value: true
mirror: always
rust: true
# Pref to control whether XUL ::-tree-* pseudo-elements are parsed in content
# pages.
- name: layout.css.xul-tree-pseudos.content.enabled
type: RelaxedAtomicBool
value: false
mirror: always
rust: true
# Whether to block large cursors intersecting UI.
- name: layout.cursor.block.enabled
type: bool
value: true
mirror: always
# The maximum width or height of the cursor we should allow when intersecting
# the UI, in CSS pixels.
- name: layout.cursor.block.max-size
type: uint32_t
value: 32
mirror: always
- name: layout.display-list.build-twice
type: RelaxedAtomicBool
value: false
mirror: always
# Toggle retaining display lists between paints.
- name: layout.display-list.retain
type: RelaxedAtomicBool
value: true
mirror: always
# Toggle retaining display lists between paints.
- name: layout.display-list.retain.chrome
type: RelaxedAtomicBool
value: true
mirror: always
- name: layout.display-list.retain.verify
type: RelaxedAtomicBool
value: false
mirror: always
- name: layout.display-list.retain.verify.order
type: RelaxedAtomicBool
value: false
mirror: always
# Set the maximum number of modified frames allowed before doing a full
# display list rebuild.
- name: layout.display-list.rebuild-frame-limit
type: RelaxedAtomicUint32
value: 500
mirror: always
# Pref to dump the display list to the log. Useful for debugging drawing.
- name: layout.display-list.dump
type: RelaxedAtomicBool
value: false
mirror: always
# Pref to dump the display list to the log. Useful for debugging drawing.
- name: layout.display-list.dump-content
type: RelaxedAtomicBool
value: false
mirror: always
# Pref to dump the display list to the log. Useful for debugging drawing.
- name: layout.display-list.dump-parent
type: RelaxedAtomicBool
value: false
mirror: always
- name: layout.display-list.show-rebuild-area
type: RelaxedAtomicBool
value: false
mirror: always
- name: layout.display-list.flatten-transform
type: RelaxedAtomicBool
value: true
mirror: always
# Are dynamic reflow roots enabled?
- name: layout.dynamic-reflow-roots.enabled
type: bool
value: @IS_EARLY_BETA_OR_EARLIER@
mirror: always
# Pref to control browser frame rate, in Hz. A value <= 0 means choose
# automatically based on knowledge of the platform (or 60Hz if no platform-
# specific information is available).
- name: layout.frame_rate
type: RelaxedAtomicInt32
value: -1
mirror: always
# The time in number of frames that we estimate for a refresh driver
# to be quiescent.
- name: layout.idle_period.required_quiescent_frames
type: uint32_t
value: 2
mirror: always
# The amount of time (milliseconds) needed between an idle period's
# end and the start of the next tick to avoid jank.
- name: layout.idle_period.time_limit
type: uint32_t
value: 1
mirror: always
# Enable/disable interruptible reflow, which allows reflows to stop
# before completion (and display the partial results) when user events
# are pending.
- name: layout.interruptible-reflow.enabled
type: bool
value: true
mirror: always
- name: layout.min-active-layer-size
type: int32_t
value: 64
mirror: always
- name: layout.paint_rects_separately
type: bool
value: true
mirror: once
- name: layout.reflow.synthMouseMove
type: bool
value: true
mirror: always
# This pref is to be set by test code only.
- name: layout.scrollbars.always-layerize-track
type: RelaxedAtomicBool
value: false
mirror: always
# If layout.show_previous_page is true then during loading of a new page we
# will draw the previous page if the new page has painting suppressed.
- name: layout.show_previous_page
type: bool
value: true
mirror: always
- name: layout.smaller-painted-layers
type: RelaxedAtomicBool
value: false
mirror: always
- name: layout.lower_priority_refresh_driver_during_load
type: bool
value: true
mirror: always
# Is layout of CSS outline-style:auto enabled?
- name: layout.css.outline-style-auto.enabled
type: bool
value: false
mirror: always
# Pref to control enabling scroll anchoring.
- name: layout.css.scroll-anchoring.enabled
type: bool
value: true
mirror: always
# Pref to control how many consecutive scroll-anchoring adjustments (since the
# most recent user scroll) we'll average, before we consider whether to
# automatically turn off scroll anchoring. When we hit this threshold, the
# actual decision to disable also depends on the
# min-average-adjustment-threshold pref, see below for more details.
#
# Zero disables the heuristic.
- name: layout.css.scroll-anchoring.max-consecutive-adjustments
type: uint32_t
value: 10
mirror: always
# Pref to control whether we should disable scroll anchoring on a scroller
# where at least max-consecutive-adjustments have happened, and which the
# average adjustment ends up being less than this number, in CSS pixels.
#
# So, for example, given max-consecutive-adjustments=10 and
# min-average-adjustment-treshold=3, we'll block scroll anchoring if there have
# been 10 consecutive adjustments without a user scroll or more, and the
# average offset difference between them amount to less than 3 CSS pixels.
- name: layout.css.scroll-anchoring.min-average-adjustment-threshold
type: uint32_t
value: 3
mirror: always
# Pref to control disabling scroll anchoring suppression triggers, see
#
# https://drafts.csswg.org/css-scroll-anchoring/#suppression-triggers
#
# Those triggers should be unnecessary after bug 1561450.
- name: layout.css.scroll-anchoring.suppressions.enabled
type: bool
value: true
mirror: always
- name: layout.css.scroll-anchoring.highlight
type: bool
value: false
mirror: always
# Are shared memory User Agent style sheets enabled?
- name: layout.css.shared-memory-ua-sheets.enabled
type: bool
value: true
mirror: always
- name: layout.css.shadow-parts.enabled
type: RelaxedAtomicBool
value: @IS_NIGHTLY_BUILD@
mirror: always
rust: true
# Is support for CSS text-justify property enabled?
- name: layout.css.text-justify.enabled
type: bool
value: true
mirror: always
# Is support for -webkit-line-clamp enabled?
- name: layout.css.webkit-line-clamp.enabled
type: bool
value: true
mirror: always
# Whether the computed value of line-height: normal returns the `normal`
# keyword rather than a pixel value based on the first available font.
#
# Only enabled on Nightly and early beta, at least for now.
#
# It'd be nice to make numbers compute also to themselves, but it looks like
# everybody agrees on turning them into pixels, see the discussion starting
# from [1].
#
# [1]: https://github.com/w3c/csswg-drafts/issues/3749#issuecomment-477287453
- name: layout.css.line-height.normal-as-resolved-value.enabled
type: bool
value: true
mirror: always
# Are the width and height attributes on image-like elements mapped to the
# internal-for-now aspect-ratio property?
- name: layout.css.width-and-height-map-to-aspect-ratio.enabled
type: bool
value: true
mirror: always
# The fraction of the scrollport we allow to horizontally scroll by before we
# schedule an update of frame visibility.
- name: layout.framevisibility.amountscrollbeforeupdatehorizontal
type: int32_t
value: 2
mirror: always
# The fraction of the scrollport we allow to vertically scroll by before we
# schedule an update of frame visibility.
- name: layout.framevisibility.amountscrollbeforeupdatevertical
type: int32_t
value: 2
mirror: always
# Whether we expand the layout viewport even if the expanded viewport doesn't
# contain any contents in the area.
- name: layout.viewport_contains_no_contents_area
type: bool
value: true
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "mathml."
#---------------------------------------------------------------------------
# Whether to disable deprecated style attributes background, color, fontfamily,
# fontsize, fontstyle and fontweight.
- name: mathml.deprecated_style_attributes.disabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Whether to disable deprecated "radical" notation for the menclose element.
- name: mathml.deprecated_menclose_notation_radical.disabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Whether to disable legacy MathML number values that are not valid CSS numbers
# (e.g. "1234.")
- name: mathml.legacy_number_syntax.disabled
type: bool
value: true
mirror: always
# Whether to disable legacy names "small", "normal" and "big" for the
# mathsize attribute.
- name: mathml.mathsize_names.disabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Whether to disable legacy names "thickmathspace", "mediummathspace",
# "thickmathspace" etc for length attributes.
- name: mathml.mathspace_names.disabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Whether to disable the mfrac bevelled attribute.
- name: mathml.mfrac_bevelled_attribute.disabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Whether to disable the mfenced element.
- name: mathml.mfenced_element.disabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Whether to disable legacy names "thin", "thick" and "medium" for the
# linethickness attribute of the mfrac element.
- name: mathml.mfrac_linethickness_names.disabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Whether to disable nonzero unitless values e.g. linethickness="2" for 200%
- name: mathml.nonzero_unitless_lengths.disabled
type: bool
value: true
mirror: always
# Whether to disable deprecated numalign/denomalign/align attributes
- name: mathml.deprecated_alignment_attributes.disabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Whether to disable subscriptshift and superscriptshift attributes.
- name: mathml.script_shift_attributes.disabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Whether to disable support for XLink on MathML elements.
- name: mathml.xlink.disabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "media."
#---------------------------------------------------------------------------
# These prefs use camel case instead of snake case for the getter because one
# reviewer had an unshakeable preference for that. Who could that be?
# If "media.autoplay.default" is not ALLOWED, and this pref is true,
# then audible media would only be allowed to autoplay after website has
# been activated by specific user gestures, but non-audible
# media won't be restricted.
- name: media.autoplay.enabled.user-gestures-needed
type: bool
value: false
mirror: always
# File-backed MediaCache size.
- name: media.cache_size
type: RelaxedAtomicUint32
value: 512000 # Measured in KiB
mirror: always
# Size of file backed MediaCache while on a connection which is cellular (3G,
# etc), and thus assumed to be "expensive".
- name: media.cache_size.cellular
type: RelaxedAtomicUint32
value: 32768 # Measured in KiB
mirror: always
# Whether cubeb is sandboxed
- name: media.cubeb.sandbox
type: bool
mirror: always
#if defined(XP_LINUX) && !defined(MOZ_WIDGET_ANDROID)
value: true
#else
value: false
#endif
# If a resource is known to be smaller than this size (in kilobytes), a
# memory-backed MediaCache may be used; otherwise the (single shared global)
# file-backed MediaCache is used.
- name: media.memory_cache_max_size
type: uint32_t
value: 8192 # Measured in KiB
mirror: always
# Don't create more memory-backed MediaCaches if their combined size would go
# above this absolute size limit.
- name: media.memory_caches_combined_limit_kb
type: uint32_t
value: 524288
mirror: always
# Don't create more memory-backed MediaCaches if their combined size would go
# above this relative size limit (a percentage of physical memory).
- name: media.memory_caches_combined_limit_pc_sysmem
type: uint32_t
value: 5 # A percentage
mirror: always
# When a network connection is suspended, don't resume it until the amount of
# buffered data falls below this threshold (in seconds).
- name: media.cache_resume_threshold
type: RelaxedAtomicUint32
value: 30
mirror: always
- name: media.cache_resume_threshold.cellular
type: RelaxedAtomicUint32
value: 10
mirror: always
# Stop reading ahead when our buffered data is this many seconds ahead of the
# current playback position. This limit can stop us from using arbitrary
# amounts of network bandwidth prefetching huge videos.
- name: media.cache_readahead_limit
type: RelaxedAtomicUint32
value: 60
mirror: always
- name: media.cache_readahead_limit.cellular
type: RelaxedAtomicUint32
value: 30
mirror: always
# MediaCapabilities
- name: media.mediacapabilities.drop-threshold
type: RelaxedAtomicInt32
value: 95
mirror: always
- name: media.mediacapabilities.from-database
type: RelaxedAtomicBool
value: @IS_NIGHTLY_BUILD@
mirror: always
# AudioSink
- name: media.resampling.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# libcubeb backend implements .get_preferred_channel_layout
- name: media.forcestereo.enabled
type: RelaxedAtomicBool
#if defined(XP_WIN) || defined(XP_DARWIN) || defined(MOZ_PULSEAUDIO)
value: false
#else
value: true
#endif
mirror: always
# MediaSource
# Whether to enable MediaSource support.
- name: media.mediasource.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: media.mediasource.mp4.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: media.mediasource.webm.enabled
type: RelaxedAtomicBool
#if defined(XP_WIN) || defined(XP_MACOSX) || defined(MOZ_WIDGET_ANDROID)
value: true
#else
value: false
#endif
mirror: always
- name: media.mediasource.webm.audio.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Whether to enable MediaSource v2 support.
- name: media.mediasource.experimental.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# VideoSink
- name: media.ruin-av-sync.enabled
type: RelaxedAtomicBool
value: false
mirror: always
# Encrypted Media Extensions
- name: media.eme.enabled
type: bool
#if defined(ANDROID)
value: @IS_NIGHTLY_BUILD@
#elif defined(XP_LINUX)
# On Linux EME is visible but disabled by default. This is so that the "Play
# DRM content" checkbox in the Firefox UI is unchecked by default. DRM
# requires downloading and installing proprietary binaries, which users on an
# open source operating systems didn't opt into. The first time a site using
# EME is encountered, the user will be prompted to enable DRM, whereupon the
# EME plugin binaries will be downloaded if permission is granted.
value: false
#else
value: true
#endif
mirror: always
# Whether we expose the functionality proposed in
# https://github.com/WICG/encrypted-media-encryption-scheme/blob/master/explainer.md
# I.e. if true, apps calling navigator.requestMediaKeySystemAccess() can pass
# an optional encryption scheme as part of MediaKeySystemMediaCapability
# objects. If a scheme is present when we check for support, we must ensure we
# support that scheme in order to provide key system access.
- name: media.eme.encrypted-media-encryption-scheme.enabled
type: bool
value: false
mirror: always
- name: media.clearkey.persistent-license.enabled
type: bool
value: false
mirror: always
- name: media.cloneElementVisually.testing
type: bool
value: false
mirror: always
#if defined(XP_LINUX) && defined(MOZ_SANDBOX)
# Whether to allow, on a Linux system that doesn't support the necessary
# sandboxing features, loading Gecko Media Plugins unsandboxed. However, EME
# CDMs will not be loaded without sandboxing even if this pref is changed.
- name: media.gmp.insecure.allow
type: RelaxedAtomicBool
value: false
mirror: always
#endif
# Specifies whether the PDMFactory can create a test decoder that just outputs
# blank frames/audio instead of actually decoding. The blank decoder works on
# all platforms.
- name: media.use-blank-decoder
type: RelaxedAtomicBool
value: false
mirror: always
- name: media.gpu-process-decoder
type: RelaxedAtomicBool
#if defined(XP_WIN)
value: true
#else
value: false
#endif
mirror: always
- name: media.rdd-process.enabled
type: RelaxedAtomicBool
#if defined(XP_WIN)
#if defined(_ARM64_)
value: false
#else
value: true
#endif
#elif defined(XP_MACOSX)
value: true
#elif defined(XP_LINUX) && !defined(ANDROID)
value: true
#else
value: false
#endif
mirror: always
- name: media.rdd-process.startup_timeout_ms
type: RelaxedAtomicInt32
value: 5000
mirror: always
- name: media.rdd-vorbis.enabled
type: RelaxedAtomicBool
#if defined(XP_LINUX) && !defined(ANDROID)
value: true
#elif defined(XP_MACOSX)
value: true
#else
value: false
#endif
mirror: always
- name: media.rdd-wav.enabled
type: RelaxedAtomicBool
#if defined(XP_LINUX) && !defined(ANDROID)
value: true
#elif defined(XP_WIN) && !defined(_ARM64_)
value: false
#elif defined(XP_MACOSX)
value: true
#else
value: false
#endif
mirror: always
- name: media.rdd-opus.enabled
type: RelaxedAtomicBool
#if defined(XP_LINUX) && !defined(ANDROID)
value: true
#elif defined(XP_WIN) && !defined(_ARM64_)
value: false
#elif defined(XP_MACOSX)
value: true
#else
value: false
#endif
mirror: always
- name: media.rdd-webaudio.batch.size
type: RelaxedAtomicInt32
value: 100
mirror: always
#ifdef ANDROID
# Enable the MediaCodec PlatformDecoderModule by default.
- name: media.android-media-codec.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: media.android-media-codec.preferred
type: RelaxedAtomicBool
value: true
mirror: always
#endif # ANDROID
#ifdef MOZ_OMX
- name: media.omx.enabled
type: bool
value: false
mirror: always
#endif
#ifdef MOZ_FFMPEG
- name: media.ffmpeg.enabled
type: RelaxedAtomicBool
#if defined(XP_MACOSX)
value: false
#else
value: true
#endif
mirror: always
- name: media.libavcodec.allow-obsolete
type: bool
value: false
mirror: always
#endif # MOZ_FFMPEG
#ifdef MOZ_FFVPX
- name: media.ffvpx.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: media.ffvpx.mp3.enabled
type: RelaxedAtomicBool
value: true
mirror: always
#endif
#if defined(MOZ_FFMPEG) || defined(MOZ_FFVPX)
- name: media.ffmpeg.low-latency.enabled
type: RelaxedAtomicBool
value: false
mirror: always
#endif
#ifdef MOZ_WMF
- name: media.wmf.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Whether DD should consider WMF-disabled a WMF failure, useful for testing.
- name: media.decoder-doctor.wmf-disabled-is-failure
type: bool
value: false
mirror: always
- name: media.wmf.dxva.d3d11.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: media.wmf.dxva.max-videos
type: RelaxedAtomicUint32
value: 8
mirror: always
- name: media.wmf.use-nv12-format
type: RelaxedAtomicBool
value: true
mirror: always
- name: media.wmf.force.allow-p010-format
type: RelaxedAtomicBool
value: false
mirror: always
- name: media.wmf.use-sync-texture
type: bool
value: true
mirror: once
- name: media.wmf.low-latency.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: media.wmf.low-latency.force-disabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: media.wmf.skip-blacklist
type: RelaxedAtomicBool
value: false
mirror: always
- name: media.wmf.deblacklisting-for-telemetry-in-gpu-process
type: RelaxedAtomicBool
value: true
mirror: always
- name: media.wmf.amd.highres.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: media.wmf.allow-unsupported-resolutions
type: RelaxedAtomicBool
value: false
mirror: always
- name: media.wmf.vp9.enabled
type: bool
value: true
mirror: once
#endif # MOZ_WMF
- name: media.hardware-video-decoding.force-enabled
type: bool
value: false
mirror: once
# Whether to check the decoder supports recycling.
- name: media.decoder.recycle.enabled
type: RelaxedAtomicBool
value: @IS_ANDROID@
mirror: always
# Should MFR try to skip to the next key frame?
- name: media.decoder.skip-to-next-key-frame.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: media.gmp.decoder.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: media.eme.audio.blank
type: RelaxedAtomicBool
value: false
mirror: always
- name: media.eme.video.blank
type: RelaxedAtomicBool
value: false
mirror: always
- name: media.eme.chromium-api.video-shmems
type: RelaxedAtomicUint32
value: 6
mirror: always
# Whether to suspend decoding of videos in background tabs.
- name: media.suspend-bkgnd-video.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Delay, in ms, from time window goes to background to suspending
# video decoders. Defaults to 10 seconds.
- name: media.suspend-bkgnd-video.delay-ms
type: RelaxedAtomicUint32
value: 10000
mirror: always
- name: media.dormant-on-pause-timeout-ms
type: RelaxedAtomicInt32
value: 5000
mirror: always
# AudioTrack and VideoTrack support
- name: media.track.enabled
type: bool
value: false
mirror: always
# This pref disables the reception of RTCP. It is used for testing.
- name: media.webrtc.net.force_disable_rtcp_reception
type: ReleaseAcquireAtomicBool
value: false
mirror: always
# TextTrack WebVTT Region extension support.
- name: media.webvtt.regions.enabled
type: bool
value: true
mirror: always
# This pref controls whether dispatch testing-only events.
- name: media.webvtt.testing.events
type: bool
value: true
mirror: always
- name: media.webspeech.synth.force_global_queue
type: bool
value: false
mirror: always
- name: media.webspeech.test.enable
type: bool
value: false
mirror: always
- name: media.webspeech.test.fake_fsm_events
type: bool
value: false
mirror: always
- name: media.webspeech.test.fake_recognition_service
type: bool
value: false
mirror: always
#ifdef MOZ_WEBSPEECH
- name: media.webspeech.recognition.enable
type: bool
value: false
mirror: always
#endif
- name: media.webspeech.recognition.force_enable
type: bool
value: false
mirror: always
#ifdef MOZ_WEBSPEECH
- name: media.webspeech.synth.enabled
type: bool
value: false
mirror: always
#endif # MOZ_WEBSPEECH
- name: media.encoder.webm.enabled
type: RelaxedAtomicBool
#if defined(MOZ_WEBM_ENCODER)
value: true
#else
value: false
#endif
mirror: always
- name: media.audio-max-decode-error
type: uint32_t
#if defined(RELEASE_OR_BETA)
value: 3
#else
# Zero tolerance in pre-release builds to detect any decoder regression.
value: 0
#endif
mirror: always
- name: media.video-max-decode-error
type: uint32_t
#if defined(RELEASE_OR_BETA)
value: 2
#else
# Zero tolerance in pre-release builds to detect any decoder regression.
value: 0
#endif
mirror: always
# Are video stats enabled? (Disabling can help prevent fingerprinting.)
- name: media.video_stats.enabled
type: bool
value: true
mirror: always
# Opus
- name: media.opus.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Wave
- name: media.wave.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# Ogg
- name: media.ogg.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# WebM
- name: media.webm.enabled
type: RelaxedAtomicBool
value: true
mirror: always
# AV1
- name: media.av1.enabled
type: RelaxedAtomicBool
#if defined(XP_WIN) && !defined(_ARM64_)
value: true
#elif defined(XP_MACOSX)
value: true
#elif defined(XP_UNIX) && !defined(ANDROID)
value: true
#else
value: false
#endif
mirror: always
- name: media.av1.use-dav1d
type: RelaxedAtomicBool
#if defined(XP_WIN) && !defined(_ARM64_)
value: true
#elif defined(XP_MACOSX)
value: true
#elif defined(XP_UNIX) && !defined(ANDROID)
value: true
#else
value: false
#endif
mirror: always
- name: media.flac.enabled
type: bool
value: true
mirror: always
# Hls
- name: media.hls.enabled
type: RelaxedAtomicBool
value: @IS_ANDROID@
mirror: always
# Max number of HLS players that can be created concurrently. Used only on
# Android and when "media.hls.enabled" is true.
#ifdef ANDROID
- name: media.hls.max-allocations
type: uint32_t
value: 20
mirror: always
#endif
- name: media.mp4.enabled
type: RelaxedAtomicBool
#ifdef MOZ_FMP4
value: true
#else
value: false
#endif
mirror: always
# Error/warning handling, Decoder Doctor.
#
# Set to true to force demux/decode warnings to be treated as errors.
- name: media.playback.warnings-as-errors
type: RelaxedAtomicBool
value: false
mirror: always
# Resume video decoding when the cursor is hovering on a background tab to
# reduce the resume latency and improve the user experience.
- name: media.resume-bkgnd-video-on-tabhover
type: bool
value: true
mirror: always
- name: media.videocontrols.lock-video-orientation
type: bool
value: @IS_ANDROID@
mirror: always
# Media Seamless Looping
- name: media.seamless-looping
type: RelaxedAtomicBool
value: true
mirror: always
- name: media.autoplay.block-event.enabled
type: bool
value: false
mirror: always
- name: media.media-capabilities.enabled
type: RelaxedAtomicBool
value: true
mirror: always
- name: media.media-capabilities.screen.enabled
type: RelaxedAtomicBool
value: false
mirror: always
- name: media.benchmark.vp9.fps
type: RelaxedAtomicUint32
value: 0
mirror: always
- name: media.benchmark.vp9.threshold
type: RelaxedAtomicUint32
value: 150
mirror: always
- name: media.benchmark.vp9.versioncheck
type: RelaxedAtomicUint32
value: 0
mirror: always
- name: media.benchmark.frames
type: RelaxedAtomicUint32
value: 300
mirror: always
- name: media.benchmark.timeout
type: RelaxedAtomicUint32
value: 1000
mirror: always
- name: media.test.video-suspend
type: RelaxedAtomicBool
value: false
mirror: always
# MediaCapture prefs follow
# Enables navigator.mediaDevices and getUserMedia() support. See also
# media.peerconnection.enabled
- name: media.navigator.enabled
type: bool
value: true
mirror: always
# This pref turns off [SecureContext] on the navigator.mediaDevices object, for
# more compatible legacy behavior.
- name: media.devices.insecure.enabled
type: bool
value: false
mirror: always
# If the above pref is also enabled, this pref enabled getUserMedia() support
# in http, bypassing the instant NotAllowedError you get otherwise.
- name: media.getusermedia.insecure.enabled
type: bool
value: false
mirror: always
# WebRTC prefs follow
# Enables RTCPeerConnection support. Note that, when true, this pref enables
# navigator.mediaDevices and getUserMedia() support as well.
# See also media.navigator.enabled
- name: media.peerconnection.enabled
type: bool
value: true
mirror: always
- name: media.peerconnection.dtmf.enabled
type: bool
value: true
mirror: always
- name: media.peerconnection.identity.enabled
type: bool
value: true
mirror: always
- name: media.peerconnection.rtpsourcesapi.enabled
type: bool
value: true
mirror: always
#ifdef MOZ_WEBRTC
#ifdef ANDROID
- name: media.navigator.hardware.vp8_encode.acceleration_remote_enabled
type: bool
value: true
mirror: always
- name: media.navigator.hardware.vp8_encode.acceleration_enabled
type: bool
value: true
mirror: never
- name: media.navigator.hardware.vp8_decode.acceleration_enabled
type: bool
value: false
mirror: never
#endif # ANDROID
# Use MediaDataDecoder API for VP8/VP9 in WebRTC. This includes hardware
# acceleration for decoding.
- name: media.navigator.mediadatadecoder_vpx_enabled
type: RelaxedAtomicBool
#if defined(NIGHTLY_BUILD)
value: true
#else
value: false
#endif
mirror: always
# Use MediaDataDecoder API for H264 in WebRTC. This includes hardware
# acceleration for decoding.
- name: media.navigator.mediadatadecoder_h264_enabled
type: RelaxedAtomicBool
#if defined(_ARM64_) && defined(XP_WIN)
value: false
#else
value: true
#endif
mirror: always
#endif # MOZ_WEBRTC
# HTMLMediaElement.allowedToPlay should be exposed to web content when
# block autoplay rides the trains to release. Until then, Nightly only.
- name: media.allowed-to-play.enabled
type: bool
value: @IS_NIGHTLY_BUILD@
mirror: always
# Is support for MediaKeys.getStatusForPolicy enabled?
- name: media.eme.hdcp-policy-check.enabled
type: bool
value: false
mirror: always
# Is support for MediaDevices.ondevicechange enabled?
- name: media.ondevicechange.enabled
type: bool
value: true
mirror: always
# Is support for HTMLMediaElement.seekToNextFrame enabled?
- name: media.seekToNextFrame.enabled
type: bool
value: true
mirror: always
# setSinkId will be enabled in bug 1498512. Till then the
# implementation will remain hidden behind this pref (Bug 1152401, Bug 934425).
- name: media.setsinkid.enabled
type: bool
value: false
mirror: always
- name: media.useAudioChannelService.testing
type: bool
value: false
mirror: always
- name: media.audioFocus.management
type: bool
#if defined(MOZ_WIDGET_ANDROID) && defined(NIGHTLY_BUILD)
value: true
#else
value: false
#endif
mirror: always
- name: media.hardwaremediakeys.enabled
type: bool
value: false
mirror: always
- name: media.webrtc.platformencoder
type: bool
value: false
mirror: always
- name: media.block-autoplay-until-in-foreground
type: bool
#if !defined(MOZ_WIDGET_ANDROID)
value: true
#else
value: false
#endif
mirror: always
- name: media.webrtc.hw.h264.enabled
type: bool
value: false
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "mousewheel."
#---------------------------------------------------------------------------
# This affects how line scrolls from wheel events will be accelerated.
# Factor to be multiplied for constant acceleration.
- name: mousewheel.acceleration.factor
type: RelaxedAtomicInt32
value: 10
mirror: always
# This affects how line scrolls from wheel events will be accelerated.
# Number of mousewheel clicks when acceleration starts.
# Acceleration can be turned off if pref is set to -1.
- name: mousewheel.acceleration.start
type: RelaxedAtomicInt32
value: -1
mirror: always
# This affects whether events will be routed through APZ or not.
- name: mousewheel.system_scroll_override_on_root_content.enabled
type: RelaxedAtomicBool
#ifdef XP_WIN
value: true
#else
value: false
#endif
mirror: always
# Prefs for overriding the system mouse wheel scrolling speed on
# content of the web pages. When
# "mousewheel.system_scroll_override_on_root_content.enabled" is true and the
# system scrolling speed isn't customized by the user, the content scrolling
# speed is multiplied by the following factors. The value will be used as
# 1/100. E.g., 200 means 2.00.
# NOTE: Even if "mousewheel.system_scroll_override_on_root_content.enabled" is
# true, when Gecko detects the user customized the system scrolling speed
# settings, the override isn't executed.
- name: mousewheel.system_scroll_override_on_root_content.horizontal.factor
type: RelaxedAtomicInt32
value: 200
mirror: always
- name: mousewheel.system_scroll_override_on_root_content.vertical.factor
type: RelaxedAtomicInt32
value: 200
mirror: always
# Mouse wheel scroll transaction is held even if the mouse cursor is moved.
- name: mousewheel.transaction.ignoremovedelay
type: RelaxedAtomicInt32
value: 100
mirror: always
# Mouse wheel scroll transaction period of time (in milliseconds).
- name: mousewheel.transaction.timeout
type: RelaxedAtomicInt32
value: 1500
mirror: always
# Mouse wheel scroll position is determined by GetMessagePos rather than
# LPARAM msg value
- name: mousewheel.ignore_cursor_position_in_lparam
type: RelaxedAtomicBool
value: false
mirror: always
#---------------------------------------------------------------------------
# Prefs starting with "network."
#---------------------------------------------------------------------------
# Force less-secure NTLMv1 when needed (NTLMv2 is the default).
- name: network.auth.force-generic-ntlm-v1
type: RelaxedAtomicBool
value: false
mirror: always
# Sub-resources HTTP-authentication:
# 0 - don't allow sub-resources to open HTTP authentication credentials
# dialogs
# 1 - allow sub-resources to open HTTP authentication credentials dialogs,
# but don't allow it for cross-origin sub-resources
# 2 - allow the cross-origin authentication as well. 