ページ読み込みのリッスン

このチュートリアルに沿って学習するには、あらかじめ SDK をインストールし、cfx 入門を学習してください。

tabs モジュールを使用して、新しいページが読み込まれたときに通知を受け取ることができます。以下のアドオンは、タブに内蔵されている ready イベントをリッスンし、ユーザーがタブに URL を読み込んだときにその URL をコンソールに出力します。

?
1
2
3
4
5
require("tabs").on("ready", logURL);
 
function logURL(tab) {
  console.log(tab.url);
}

タブにホストされているコンテンツには直接アクセスできません。

タブのコンテンツにアクセスするには、tab.attach() を使用してタブにスクリプトを付加する必要があります。以下のアドオンは、開いているすべてのタブにスクリプトを付加します。付加されたスクリプトは、タブ内の文書に赤い枠を追加します。

?
1
2
3
4
5
6
7
8
9
10
11
require("tabs").on("ready", logURL);
 
function logURL(tab) {
  runScript(tab);
}
 
function runScript(tab) {
  tab.attach({
    contentScript: "if (document.body) document.body.style.border = '5px solid red';"
  });
}

（上のアドオンは、概念をわかりやすく示すための例に過ぎません。このような動作を実際に実装するには、page-mod を代わりに使用し、一致パターンとして「*」を指定します）

さらに詳しく

SDK でのタブの使用方法の詳細については、API リファレンス：tabs（英語）を参照してください。この他にも、open、close、activate などのタブイベントをリッスンできます。

タブでスクリプトを実行する方法の詳細については、tab.attach() の使用方法についてのチュートリアルを参照してください。