Skip to content

Latest commit

 

History

History
89 lines (68 loc) · 3.76 KB

index.md

File metadata and controls

89 lines (68 loc) · 3.76 KB
title slug
tabs.onCreated
Mozilla/Add-ons/WebExtensions/API/tabs/onCreated

{{AddonSidebar}}

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

イベントが発火したとき、タブは URL を渡されていないかもしれないことに注意してください。特に、Firefox は新しいページを読み込み前に新しいタブを"about:blank"で開きます。URL がセットされたときを通知されるために{{WebExtAPIRef("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
        • : {{WebExtAPIRef('tabs.Tab')}}。生成されたタブの詳細です。

例

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

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

browser.tabs.onCreated.addListener(handleCreated);

{{WebExtExamples}}

ブラウザーの互換性

{{Compat}}

Note

この API は Chromium のchrome.tabs API に基づいています。このドキュメンテーションは Chromium code の中のtabs.jsonからの派生です。Microsoft Edge の互換性データは Microsoft Corporation から提供されており、ここに the Creative Commons Attribution 3.0 United States License のもとで含まれています。