optional_permissions

Array
必須 いいえ
"optional_permissions": [
  "*://developer.mozilla.org/*",
  "webRequest"
]

optional_permissions キーを使って、拡張機能がインストールされた後に、実行時に要求するパーミッションを一覧できます。

permissions キーは拡張機能がインストールされる時に必要とするパーミッションを一覧しますが、optional_permissions は拡張機能のインストール時には必要でないが、インストール後のどこかで要求されることのあるパーミッションを一覧します。パーミッションを要求するには、permissions API を使います。パーミッションを要求すると、おそらくユーザーに拡張機能にパーミッションを許可しても良いかを尋ねるダイアログが表示されるでしょう。

このキーは 2種類のパーミッションを含みます: ホストパーミッションと API パーミッションです。

ホストパーミッション

これは permissions キーで指定できるホストパーミッションと同じです。

API パーミッション

下記のいずれも入れることができますが、すべてのブラウザーに入ってはいません: ブラウザー固有の詳細については、互換性テーブルを確認してください:

  • activeTab
  • background
  • bookmarks
  • browserSettings
  • clipboardRead
  • clipboardWrite
  • contentSettings
  • contextMenus
  • cookies
  • debugger
  • downloads
  • downloads.open
  • geolocation
  • history
  • idle
  • management
  • notifications
  • pageCapture
  • tabs
  • topSites
  • webNavigation
  • webRequest
  • webRequestBlocking

これは permissions で許可される API パーミッションのサブセットです。

このセットでは、下記のパーミッションが、ユーザープロンプトなしで暗黙的に許可されます: activeTab, cookies, idle, webRequest, webRequestBlocking

 "optional_permissions": ["*://developer.mozilla.org/*"]

拡張機能に developer.mozilla.org 以下のページの権限アクセス要求を有効にします。

  "optional_permissions": ["tabs"]

拡張機能に tabs API の権限部分へのアクセス要求を有効にします。

  "optional_permissions": ["*://developer.mozilla.org/*", "tabs"]

拡張機能に上記の両方への要求を有効にします。

ブラウザー実装状況

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxOperaAndroid 版 Firefox
基本対応Chrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 完全対応 55
activeTabChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 55Opera 未対応 なしFirefox Android 完全対応 55
backgroundChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 完全対応 ありFirefox Android 未対応 なし
bookmarksChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 未対応 なし
browserSettingsChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 57Opera 未対応 なしFirefox Android 完全対応 57
clipboardReadChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 完全対応 55
clipboardWriteChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 完全対応 55
contentSettingsChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 完全対応 ありFirefox Android 未対応 なし
contextMenusChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 完全対応 ありFirefox Android 未対応 なし
cookiesChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 完全対応 55
debuggerChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 完全対応 ありFirefox Android 未対応 なし
downloadsChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 60Opera 未対応 なしFirefox Android 完全対応 60
downloads.openChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 60Opera 未対応 なしFirefox Android 完全対応 60
findChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 57Opera 未対応 なしFirefox Android 未対応 なし
geolocationChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 55Opera 未対応 なしFirefox Android 完全対応 55
historyChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 未対応 なし
idleChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 完全対応 55
managementChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 完全対応 ありFirefox Android 未対応 なし
notificationsChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 完全対応 55
pageCaptureChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 完全対応 ありFirefox Android 未対応 なし
tabHideChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 61Opera 未対応 なしFirefox Android 未対応 なし
tabsChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 完全対応 55
topSitesChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 完全対応 55
webNavigationChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 完全対応 55
webRequestChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 完全対応 55
webRequestBlockingChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 完全対応 ありFirefox Android 完全対応 55

凡例

完全対応  
完全対応
未対応  
未対応

ドキュメントのタグと貢献者

このページの貢献者: Uemmra3
最終更新者: Uemmra3,