runtime.onInstalled

browser.runtime.onInstalled.addListener(listener)
browser.runtime.onInstalled.removeListener(listener)
browser.runtime.onInstalled.hasListener(listener)

イベントには 3 つの関数があります:

addListener(callback)

このイベントにリスナーを追加します。

removeListener(listener)

イベントリスナーを停止します。listener 引数は削除するリスナーです。

hasListener(listener)

listener がこのイベントに登録されているか確認します。登録されていば true、そうでない場合は false を返します。

function

イベントが起こったときに呼び出されるコールバック関数です。この関数には以下の引数が渡されます:

details

以下のプロパティを持つオブジェクトです:

id 省略可

string 型。更新されたモジュール共有中の拡張機能の ID です。reason の値が shared_module_update の時のみ設定されます。

previousVersion 省略可

string 型。更新前の拡張機能のバージョンです。reason の値が update の時のみ設定されます。

reason

runtime.OnInstalledReason の値で、このイベントが発火した理由を表します。

temporary

boolean 型。拡張機能が一時的にインストールされた場合は True です。例えば、 Firefox で "about:debugging" ページ を使ったり、 web-ext run を使った場合です。それ以外の場合は False です。

拡張機能がインストールされた時に、理由をログ出力し、 https://example.com を開きます:

function handleInstalled(details) {
  console.log(details.reason);
  browser.tabs.create({
    url: "https://example.com",
  });
}

browser.runtime.onInstalled.addListener(handleInstalled);

• runtime-examples