browserSettings

Habilita uma extensão para modificar certas configurações globais do navegador. Cada propriedade desta API é um objeto BrowserSetting, provendo a capacidade de modificar uma configuração particular.
 
Devido estas serem configurações globais, é possível haver conflito entre extensões. Veja a documentação BrowserSetting.set() para detalhes de como ligar com conflitos .
 

Para usar esta API você precisa ter a permissão "browserSettings".

Propriedades

browserSettings.allowPopupsForUserEvents
Determina se o código em execução nas páginas podem mostrar popups em resposta a eventos do usuário.
browserSettings.cacheEnabled
Determina se o cache do navegador está ou não habilitado.
browserSettings.closeTabsByDoubleClick
Determina se a aba selecionada pode ser fechada com um duplo click.
browserSettings.contextMenuShowEvent
Determina o evento do mouse que dispara um menu de contexto de popup.
browserSettings.homepageOverride
Lê o valor da página inicial do navegador.
browserSettings.imageAnimationBehavior
Determina como o navegador trata imagens animadas.
browserSettings.newTabPageOverride
Lê o valor da nova aba do navegador.
browserSettings.newTabPosition
Controla a posição de abas recentemente abertas relativa as abas já presentes.
browserSettings.openBookmarksInNewTabs
Determina se os favoritos são abertos na aba atual ou em uma nova aba.
browserSettings.openSearchResultsInNewTabs
Determina se a busca de resultados é aberta na aba atual ou em uma nova.
browserSettings.openUrlbarResultsInNewTabs
Determina se as sugestões do autocompletar da barra de endereços são abertas  na aba atual ou em uma nova.
browserSettings.overrideDocumentColors
Controla se as cores de escolha do usuário sobrescreverão as cores das páginas.
browserSettings.useDocumentFonts
Controle se o navegador usará as fontes especificadas pela página web ou somente fontes embutidas.
browserSettings.webNotificationsDisabled
Previne que os sites exibam notificações usando a API Web Notification.

Compatibilidade de browser

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
allowPopupsForUserEventsChrome No support NoEdge No support NoFirefox Full support 57Opera No support NoFirefox Android Full support 57
cacheEnabledChrome No support NoEdge No support NoFirefox Full support 56Opera No support NoFirefox Android Full support 56
closeTabsByDoubleClickChrome No support NoEdge No support NoFirefox Full support 61Opera No support NoFirefox Android No support No
contextMenuShowEventChrome No support NoEdge No support NoFirefox Full support 59Opera No support NoFirefox Android Full support 59
homepageOverrideChrome No support NoEdge No support NoFirefox Full support 57Opera No support NoFirefox Android Full support 57
imageAnimationBehaviorChrome No support NoEdge No support NoFirefox Full support 57Opera No support NoFirefox Android Full support 57
newTabPageOverrideChrome No support NoEdge No support NoFirefox Full support 57Opera No support NoFirefox Android Full support 57
newTabPositionChrome No support NoEdge No support NoFirefox Full support 61Opera No support NoFirefox Android Full support 61
Notes
Full support 61
Notes
Notes This setting can be changed but has no effect.
openBookmarksInNewTabsChrome No support NoEdge No support NoFirefox Full support 59Opera No support NoFirefox Android Full support 59
openSearchResultsInNewTabsChrome No support NoEdge No support NoFirefox Full support 59Opera No support NoFirefox Android Full support 59
openUrlbarResultsInNewTabsChrome No support NoEdge No support NoFirefox Full support 61Opera No support NoFirefox Android Full support 61
overrideDocumentColorsChrome No support NoEdge No support NoFirefox Full support 61Opera No support NoFirefox Android Full support 61
useDocumentFontsChrome No support NoEdge No support NoFirefox Full support 61Opera No support NoFirefox Android Full support 61
webNotificationsDisabledChrome No support NoEdge No support NoFirefox Full support 58Opera No support NoFirefox Android Full support 58

Legend

Full support  
Full support
No support  
No support
See implementation notes.
See implementation notes.
Tópicos relacionados
  1. Browser extensions
  2. Getting started
    1. What are extensions?
    2. Your first extension
    3. Your second extension
    4. Anatomy of an extension
    5. Example extensions
    6. What next?
  3. Concepts
    1. Using the JavaScript APIs
    2. Content scripts
    3. Match patterns
    4. Working with files
    5. Internationalization
    6. Security best practices
    7. Content Security Policy
    8. Native messaging
  4. User interface
    1. User Interface
    2. Accessibility guidelines
    3. Toolbar button
    4. Address bar button
    5. Sidebars
    6. Context menu items
    7. Options page
    8. Extension pages
    9. Notifications
    10. Address bar suggestions
    11. Developer tools panels
  5. How to
    1. Intercept HTTP requests
    2. Modify a web page
    3. Insert external content
    4. Add a button to the toolbar
    5. Implement a settings page
    6. Work with the Tabs API
    7. Work with the Bookmarks API
    8. Work with the Cookies API
    9. Work with contextual identities
    10. Build a cross-browser extension
    11. Onboard, upboard, and offboard users
  6. Porting
    1. Firefox differentiators
    2. Porting a Google Chrome extension
    3. Porting a legacy Firefox extension
    4. Comparison with the Add-on SDK
    5. Comparison with XUL/XPCOM extensions
    6. Differences between API implementations
    7. Chrome incompatibilities
    8. Differences between desktop and Android
  7. Firefox workflow
    1. Developer tools
    2. Choose a Firefox version
    3. User Experience
    4. Prompt users for data and privacy consents
    5. Temporary Installation in Firefox
    6. Debugging
    7. Testing persistent and restart features
    8. Test permission requests
    9. Developing for Firefox for Android
    10. Getting started with web-ext
    11. web-ext command reference
    12. Extensions and the Add-on ID
    13. Request the right permissions
    14. Best practices for updating your extension
  8. JavaScript APIs
    1. Browser support for JavaScript APIs
    2. alarms
    3. bookmarks
    4. browserAction
    5. browserSettings
      1. browsingData
      2. clipboard
      3. commands
      4. contentScripts
      5. contextualIdentities
      6. cookies
      7. tema
    6. Manifest keys
      1. permissões
      2. short_name
    7. Distribution Options
    8. Themes
    9. Browser themes
      1. Browser theme concepts
      2. Using the AMO theme generator
    10. Publishing and Distribution
    11. Publishing add-ons
      1. Developer accounts
      2. Signing and distribution overview
      3. Package your extension
      4. Submit an add-on
      5. Source code submission
      6. Resources for publishers
      7. Creating an appealing listing
      8. Make money from browser extensions
      9. Promoting your extension or theme
      10. Add-on policies
      11. Developer agreement
      12. Featured add-ons
      13. Retiring your extension
    12. Distributing add-ons
      1. For sideloading
      2. For desktop apps
      3. For an enterprise
    13. Community and Support
    14. Channels
      1. Add-ons blog
      2. Add-on forums
      3. Stack Overflow
      4. Contact us