tabs.onCreated

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

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

書式

js
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。生成されたタブの詳細です。

例

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

js
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 のもとで含まれています。