browserSettings

Enables an extension to modify certain global browser settings. Each property of this API is a {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} object, providing the ability to modify a particular setting.

Because these are global settings, it's possible for extensions to conflict. See the documentation for BrowserSetting.set() for details of how conflicts are handled.

To use this API, you need the "browserSettings" permission.

Properties

• {{WebExtAPIRef("browserSettings.allowPopupsForUserEvents")}}
  • : Determines whether code running in web pages can display popups in response to user events.
• {{WebExtAPIRef("browserSettings.cacheEnabled")}}
  • : Determines whether the browser cache is enabled or not.
• {{WebExtAPIRef("browserSettings.closeTabsByDoubleClick")}}
  • : Determines whether the selected tab can be closed with a double click.
• {{WebExtAPIRef("browserSettings.colorManagement")}}
  • : Determines various settings for color management.
• {{WebExtAPIRef("browserSettings.contextMenuShowEvent")}}
  • : Determines the mouse event that triggers a context menu popup.
• {{WebExtAPIRef("browserSettings.ftpProtocolEnabled")}}
  • : Determines whether the FTP protocol is enabled.
• {{WebExtAPIRef("browserSettings.homepageOverride")}}
  • : Reads the value of the browser's home page.
• {{WebExtAPIRef("browserSettings.imageAnimationBehavior")}}
  • : Determines how the browser treats animated images.
• {{WebExtAPIRef("browserSettings.newTabPageOverride")}}
  • : Reads the value of the browser's new tab page.
• {{WebExtAPIRef("browserSettings.newTabPosition")}}
  • : Controls the position of new tabs relative to the open tabs.
• {{WebExtAPIRef("browserSettings.openBookmarksInNewTabs")}}
  • : Determines whether bookmarks open in the current tab or a new tab.
• {{WebExtAPIRef("browserSettings.openSearchResultsInNewTabs")}}
  • : Determines whether search results open in the current tab or a new tab.
• {{WebExtAPIRef("browserSettings.openUrlbarResultsInNewTabs")}}
  • : Determines whether address bar autocomplete suggestions are opened in the current tab or a new tab.
• {{WebExtAPIRef("browserSettings.overrideContentColorScheme")}}
  • : Controls whether to override the browser theme (light or dark) when setting pages' preferred color scheme.
• {{WebExtAPIRef("browserSettings.overrideDocumentColors")}}
  • : Controls whether the user-chosen colors override the page's colors.
• {{WebExtAPIRef("browserSettings.tlsVersionRestrictionConfig")}}
  • : Reads the highest and lowest versions of TLS supported by the browser.
• {{WebExtAPIRef("browserSettings.useDocumentFonts")}}
  • : Controls whether the browser uses the fonts specified by a web page or uses only built-in fonts.
• {{WebExtAPIRef("browserSettings.verticalTabs")}}
  • : Controls whether the browser displays the tab bar horizontally or vertically.
• {{WebExtAPIRef("browserSettings.webNotificationsDisabled")}}
  • : Prevents websites from showing notifications using the Notification Web API.
• {{WebExtAPIRef("browserSettings.zoomFullPage")}}
  • : Controls whether zoom is applied to the entire page or to text only.
• {{WebExtAPIRef("browserSettings.zoomSiteSpecific")}}
  • : Controls whether page zoom is applied on a per-site or per-tab basis. If privacy.websites.resistFingerprinting is true, this setting has no effect and zoom is applied on a per-tab basis.

{{WebExtExamples("h2")}}

Browser compatibility

{{Compat}}