tabs.onCreated

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

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

書式

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

ブラウザ互換性

BCD tables only load in the browser

謝辞

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

Microsoft Edgeの互換性データはMicrosoft Corporationから提供されており、ここにthe Creative Commons Attribution 3.0 United States Licenseのもとで含まれています。