menus.onClicked

メニューアイテムがクリックされたときに発火します。

他のブラウザとの互換性のためにFirefoxはこのイベントを名前空間contextMenusとmenuを経由して利用可能にしています。

書式

browser.menus.onClicked.addListener(listener)
browser.menus.onClicked.removeListener(listener)
browser.menus.onClicked.hasListener(listener)

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

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

addListenerの書式

パラメータ

callback

イベントが起こったときに呼ばれる関数です。以下の引数を渡されます:

info: menus.OnClickData (en-US). Information about the item clicked and the context where the click happened.

tab: tabs.Tab. The details of the tab where the click took place. If the click did not take place in or on a tab, this parameter will be missing.

ブラウザ互換性

BCD tables only load in the browser

例

この例はメニューアイテムのクリックをリッスンし、アイテムのIDとタブのIDをログします:

browser.menus.create({
  id: "click-me",
  title: "Click me!",
  contexts: ["all"]
});

browser.menus.onClicked.addListener((info, tab) => {
  console.log("Item " + info.menuItemId + " clicked " +
              "in tab " + tab.id);
});

Example extensions

Acknowledgements

This API is based on Chromium's chrome.contextMenus API. This documentation is derived from context_menus.json in the Chromium code.