Действия браузера

Действие браузера — это кнопка, которую можно добавить в панель инструментов браузера. Пользователи могут нажать на кнопку, чтобы взаимодействовать с вашим расширением.

Play button browser action in the browser toolbar: it looks like a play button

Существует два способа указать действие браузера: с помощью поп-ап или без него.

Если вы не указываете поп-ап, при нажатии пользователем на кнопку будет отправлено событие расширению, на которое можно подписаться с помощью browserAction.onClicked:

browser.browserAction.onClicked.addListener(handleClick);

Если вы указываете поп-ап, событие клика не отправляется: вместо этого, при нажатии пользователем на кнопку будет показан поп-ап. Пользователь сможет взаимодействовать с поп-апом, и он автоматически закроется, когда пользователь кликнет вне его.

Обратите внимание, что ваше расширение может иметь только одно действие браузера.

Определение действия браузера

Вы определяете свойства действия браузера — иконку, заголовок, поп-ап — с помощью ключа browser_action в файле manifest.json:

"browser_action": {
  "default_icon": {
    "19": "button/geo-19.png",
    "38": "button/geo-38.png"
  },
  "default_title": "Whereami?",
  "default_popup": "popup/geo.html"
}

Единственным обязательным ключом является default_icon. Вы можете изменить любое из этих свойств программно с помощью API browserAction.

Примеры

В репозитории webextensions-examples на GitHub содержатся несколько примеров расширений, использующих действия браузера:

bookmark-it использует действие браузера без поп-апа
beastify использует действие браузера с поп-апом

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Browser_actions