タブが生成されたときに発火します。
イベントが発火したとき、タブはURLを渡されていないかもしれないことに注意してください。特に、Firefoxは新しいページを読み込み前に新しいタブを"about:blank"で開きます。URLがセットされたときを通知されるためにtabs.onUpdated
イベントをリッスンすることができます。
書式
browser.tabs.onCreated.addListener(callback)
browser.tabs.onCreated.removeListener(listener)
browser.tabs.onCreated.hasListener(listener)
イベントは3つの関数を持ちます:
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のもとで含まれています。