ジャンプ先:

この翻訳は不完全です。英語から この記事を翻訳 してください。

種類 Object
必須 いいえ
"background": {
  "scripts": ["background.js"]
}

background を使って拡張機能に 1 つ以上のバックグラウンドスクリプトや、オプションとしてバックグラウンドページを含めます。

バックグラウンドスクリプトは、特定のウェブページやブラウザーウィンドウとは独立した、長い期間の状態や、長い期間の操作を維持する必要があるコードを置く場所です。

バックグラウンドスクリプトは拡張機能が読み込まれるとすぐに読み込まれて、拡張機能が無効化やアンインストールされるまで読み込まれたままになります。スクリプト内では、必要な permissions を要求している限り、あらゆる WebExtension APIs を使用できます

詳しくは 拡張機能の中身の「バックグラウンドページ」の節を見てください。

background キーは次の 2 つのプロパティ(両方ともオプションです)のうち 1 つを持つオブジェクトです:

"scripts"

An array of strings, each of which is a path to a JavaScript source. The path is relative to the manifest.json file itself. These are the background scripts that will be included in the extension.

The scripts share the same window global.

The scripts are loaded in the order they appear in the array.

Note that there is a bug affecting Firefox versions earlier than 50: when the Firefox debugger is open, scripts are not always loaded in the order given in the array. To work around this bug, you can use the "page" property and include background scripts from the page using <script> tags. This bug is fixed in Firefox 50, and from that point on, scripts are always loaded in the order given in the array.

注: If you want to fetch a script from a remote location with the <script> tag (e.g. <script src = "https://code.jquery.com/jquery-1.7.1.min.js">), you will also have to change the content_security_policy key in the manifest.json file of your extension.

"page"

If you specify "scripts", then an empty page will be created for your scripts to run in.

If you need some particular content in the page, you can define your own page using the "page" option.

If you use this property, you can no longer specify background scripts using "scripts", but you can  include your own scripts from the page, just like in a normal web page.

  "background": {
    "scripts": ["jquery.js", "my-background.js"]
  }

2つのバックグラウンドスクリプトを読み込みます。

  "background": {
    "page": "my-background.html"
  }

カスタムのバックグラウンドページを読み込みます。

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxOperaAndroid 版 Firefox
基本対応Chrome 完全対応 ありEdge 完全対応 14
補足
完全対応 14
補足
補足 The 'persistent' property is mandatory.
Firefox 完全対応 48Opera 完全対応 ありFirefox Android 完全対応 48
persistentChrome 完全対応 ありEdge 完全対応 14Firefox 未対応 なしOpera 完全対応 ありFirefox Android 未対応 なし

凡例

完全対応  
完全対応
未対応  
未対応
実装ノートを参照してください。
実装ノートを参照してください。

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

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