tabs.onCreated

タブが生成されたときに発火します。

イベントが発火したとき、タブは URL を渡されていないかもしれないことに注意してください。特に、Firefox は新しいページを読み込み前に新しいタブを"about:blank"で開きます。URL がセットされたときを通知されるためにtabs.onUpdatedイベントをリッスンすることができます。

書式

browser.tabs.onCreated.addListener(callback);
browser.tabs.onCreated.removeListener(listener);
browser.tabs.onCreated.hasListener(listener);

イベントは３つの関数を持ちます:

addListener(callback): このイベントにリスナーを追加します。
removeListener(listener): このイベントのリスニングを停止します。引数listenerは削除するリスナーです。
hasListener(listener): listenerがこのイベントに登録されているかを調べます。リスニング中であればtrueを返し、そうでなければfalseを返します

addListener の書式

パラメーター

callback

このイベントが発生したときに呼び出される関数です。関数は次の引数を渡されます:

tab: tabs.Tab。生成されたタブの詳細です。

例

新しく作られたタブのログを生成します:

function handleCreated(tab) {
  console.log(tab.id);
}

browser.tabs.onCreated.addListener(handleCreated);

Example extensions

ブラウザーの互換性

メモ: この API は Chromium のchrome.tabs API に基づいています。このドキュメンテーションは Chromium code の中のtabs.jsonからの派生です。