| « 拡張機能が設定値「browser.sessionstore.restore_prompt_uri」を変更することの危険性 | [userChrome.js] Mouse Gestures » |
拡張機能が無効あるいは削除される前に何らかの処理を実行したい
ある拡張機能が無効あるいは削除される前に何らかの処理を実行したい場合がある。
拡張機能のインストールやアンインストール、無効・有効の変更の実際の処理は、 Firefox を起動してからブラウザのウィンドウが開かれるまでの間に行われるが、どうやらこのタイミングにフックして、無効あるいは削除対象の拡張機能の中の処理を実行することはできないもよう。
そのかわり、「ツール」→「アドオン」から「無効」あるいは「削除」ボタンをクリックすることである拡張機能を削除しようとするタイミングであれば、その拡張機能の中の処理を実行することは可能だ。拡張機能のインストール・アンインストール、有効・無効などの操作をしようとしたとき、「em-action-requested」というトピック名のグローバルな通知が送られるので、これを nsIObserver インタフェースを実装したオブザーバによって監視することで実現される。
トピック名「em-action-requested」のグローバルな通知が送られる時、observe メソッドに渡される引数から、どの拡張機能に対してどういう処理を行うかを判別できる。「削除」ボタンをクリックして拡張機能を削除しようとしたのであれば、3番目の引数は「item-uninstalled」である。したがってこのタイミングで、不要な設定値をリセットするなどの何らかの処理を実行させることが可能。ただし、一度削除しようとした後でも「キャンセル」ボタンをクリックして削除をやめることができるため、削除しようとした時点で処理を実行してしまうのは時期尚早といえる。この時点ではフラグを上げ下げするだけにして、実際に処理を行うのは Firefox を終了させる直前(トピック名 “quit-application” の通知が送信されるタイミング)まで待つといった工夫が必要だ。
問題点としては、「ツール」→「アドオン」からではなく、プロファイルフォルダの extensions フォルダから直接拡張機能のフォルダを削除してアンインストールした場合には対応できない点が挙げられる。
以下は “em-action-requested” の通知を監視する nsIObserver インタフェースを実装した独自XPCOMコンポーネントのコードの一部である。なお、 nsIModule::registerSelf() が呼ばれたタイミングで nsICategoryManager::addCategoryEntry() によってコンポーネントを “app-startup” カテゴリに登録することで、 Firefox 起動時(ブラウザのウィンドウが開く前)にオブザーバの登録処理を実行させることが可能となる。
_toBeDisabled: false,
_toBeUninstalled: false,
/**
* nsIObserver
*/
observe: function(aSubject, aTopic, aData)
{
var os = Cc["@mozilla.org/observer-service;1"].getService(Ci.nsIObserverService);
switch (aTopic)
{
// Firefox起動時
case "app-startup":
// オブザーバを登録
os.addObserver(this, "em-action-requested", false);
os.addObserver(this, "quit-application", true);
break;
case "em-action-requested":
const extid = "myextension@mysite.com"; // 拡張機能のID
if (aSubject instanceof Ci.nsIUpdateItem && aSubject.id == extid)
{
switch (aData)
{
case "item-disabled":
// 拡張機能を無効にしようとした
this._toBeDisabled = true;
break;
case "item-uninstalled":
// 拡張機能を削除しようとした
this._toBeUninstalled = true;
break;
case "item-cancel-action":
// 無効あるいは削除する処理をキャンセルした
this._toBeDisabled = false;
this._toBeUninstalled = false;
break;
}
}
break;
// Firefox終了時
case "quit-application":
// オブザーバの登録を解除
os.removeObserver(this, "em-action-requested");
os.removeObserver(this, "quit-application");
if (this._toBeDisabled)
{
// 拡張機能を無効にする前に何らかの処理を実行
}
if (this._toBeUninstalled)
{
// 拡張機能を削除する前に何らかの処理を実行
}
break;
}
},