browserSettings

拡張機能にグローバルなブラウザー設定の変更を可能にします。この API の各プロパティは BrowserSetting オブジェクトで、これはそれぞれの設定の変更能力を提供します。
 
これはグローバルな設定のため、拡張機能で衝突が起きる可能性があります。衝突の処理方法の詳細は BrowserSetting.set() の文書を見てください。
 

この API を使うには "browserSettings" パーミッションが必要です。

プロパティ

browserSettings.allowPopupsForUserEvents
ユーザーのイベントに反応して、ウェブページで実行しているコードがポップアップを許可するかどうかを決める
browserSettings.cacheEnabled
ブラウザーキャッシュの有効・無効を決める
browserSettings.homepageOverride
ブラウザーのホームページの値を読む
browserSettings.imageAnimationBehavior
ブラウザーが画像アニメーションをどう扱うのかを決める
browserSettings.newTabPageOverride
ブラウザーの新規タブページ値を読む
browserSettings.webNotificationsDisabled
ウェブサイトが Notification Web API を使って通知を表示するのを妨げる

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxOperaAndroid 版 Firefox
allowPopupsForUserEventsChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 57Opera 未対応 なしFirefox Android 完全対応 57
cacheEnabledChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 56Opera 未対応 なしFirefox Android 完全対応 56
closeTabsByDoubleClickChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 61Opera 未対応 なしFirefox Android 未対応 なし
contextMenuShowEventChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 59Opera 未対応 なしFirefox Android 完全対応 59
ftpProtocolEnabledChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 72Opera 未対応 なしFirefox Android 未対応 なし
homepageOverrideChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 57Opera 未対応 なしFirefox Android 完全対応 57
imageAnimationBehaviorChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 57Opera 未対応 なしFirefox Android 完全対応 57
newTabPageOverrideChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 57Opera 未対応 なしFirefox Android 完全対応 57
newTabPositionChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 61Opera 未対応 なしFirefox Android 完全対応 61
補足
完全対応 61
補足
補足 This setting can be changed but has no effect.
openBookmarksInNewTabsChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 59Opera 未対応 なしFirefox Android 完全対応 59
openSearchResultsInNewTabsChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 59Opera 未対応 なしFirefox Android 完全対応 59
openUrlbarResultsInNewTabsChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 61Opera 未対応 なしFirefox Android 完全対応 61
overrideDocumentColorsChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 61Opera 未対応 なしFirefox Android 完全対応 61
useDocumentFontsChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 61Opera 未対応 なしFirefox Android 完全対応 61
webNotificationsDisabledChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 58Opera 未対応 なしFirefox Android 完全対応 58
zoomFullPageChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 75Opera 未対応 なしFirefox Android 未対応 なし
zoomSiteSpecificChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 75Opera 未対応 なしFirefox Android 未対応 なし

凡例

完全対応  
完全対応
未対応  
未対応
実装ノートを参照してください。
実装ノートを参照してください。
関連トピック
  1. ブラウザー拡張機能
  2. 始めましょう
    1. 拡張機能とは何か?
    2. 初めての拡張機能
    3. 2つめの拡張機能
    4. 拡張機能の中身
    5. 拡張機能の例
    6. 次にどうするのか？
  3. 概念
    1. JavaScript API 群の利用
    2. コンテンツスクリプト
    3. マッチパターン
    4. ファイルの操作
    5. 多言語対応
    6. セキュリティのベストプラクティス
    7. Content Security Policy
    8. Native messaging
  4. ユーザーインターフェイス
    1. ユーザーインターフェイス
    2. Accessibility guidelines
    3. ブラウザーツールバーボタン
    4. アドレスバーボタン
    5. サイドバー
    6. コンテキストメニュー項目
    7. オプションページ
    8. ページ拡張
    9. 通知
    10. Address bar suggestions
    11. 開発ツールパネル
  5. 逆引きリファレンス
    1. HTTP リクエストへの介入
    2. web ページの変更
    3. 外部コンテンツの挿入
    4. ツールバーボタンの追加
    5. 設定画面の実装
    6. Tabs API 群の使い方
    7. Bookmark API 群の使い方
    8. Cookie API 群の使い方
    9. contextual identities の使い方
    10. Build a cross-browser extension
    11. Onboard, upboard, and offboard users
  6. 移行
    1. Firefox differentiators
    2. Google Chrome extension からの移行
    3. 古い Firefox アドオンの移行
    4. Add-on SDK との比較
    5. XUL/XPCOM 拡張との比較
    6. Differences between API implementations
    7. Chrome との非互換性
    8. デスクトップと Android の差
  7. Firefox でのワークフロー
    1. Developer tools
    2. Choose a Firefox version
    3. ユーザー体験の成功事例
    4. Prompt users for data and privacy consents
    5. Firefox への一時的なインストール
    6. デバッグ
    7. テストの持続と再起動機能
    8. Test permission requests
    9. Firefox for Android の拡張機能開発
    10. web-ext を使って始めよう
    11. web-ext コマンドリファレンス
    12. Extensions と Add-on ID
    13. 正しいパーミッションを要求する
    14. Best practices for updating your extension
  8. JavaScript API 群
    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. devtools.inspectedWindow
      8. devtools.network
      9. devtools.panels
      10. downloads
      11. events
      12. extension
      13. extensionTypes
      14. find
      15. history
      16. i18n
      17. identity
      18. idle
      19. management
      20. menus
      21. notifications
      22. omnibox
      23. pageAction
      24. permissions
      25. pkcs11
      26. privacy
      27. proxy
      28. runtime
      29. sessions
      30. sidebarAction
      31. storage
      32. tabs
      33. theme
      34. topSites
      35. types
      36. webNavigation
      37. webRequest
      38. windows
    6. Manifest keys
      1. author
      2. background
      3. browser_action
      4. browser_specific_settings
      5. chrome_settings_overrides
      6. chrome_url_overrides
      7. commands
      8. content_scripts
      9. content_security_policy
      10. default_locale
      11. description
      12. developer
      13. devtools_page
      14. homepage_url
      15. icons
      16. incognito
      17. manifest_version
      18. name
      19. omnibox
      20. optional_permissions
      21. options_ui
      22. page_action
      23. permissions
      24. protocol_handlers
      25. short_name
      26. sidebar_action
      27. theme
      28. version
      29. version_name
      30. web_accessible_resources
    7. Distribution Options
    8. テーマ
    9. ブラウザのテーマ
      1. ブラウザのテーマのコンセプト
      2. Using the AMO theme generator
    10. 公開して配布する
    11. アドオンを公開する
      1. Developer accounts
      2. 署名して配布する
      3. 拡張機能をパッケージ化する
      4. アドオンを投稿する
      5. ソースコードの提出
      6. 公開した人のためのドキュメント
      7. 魅力的に作るためのリスト
      8. Make money from browser extensions
      9. Promoting your extension or theme
      10. レビューポリシー
      11. 開発者同意事項
      12. AMO でおすすめされるアドオン
      13. 拡張機能のクロージング
    12. アドオンの配布
      1. サイドローディング
      2. デスクトップアプリ
      3. エンタープライズ
    13. コミュニティとサポート
    14. チャンネル
      1. ブログ
      2. フォーラム
      3. Stack Overflow
      4. コンタクト