внешне_подключаемый
| Тип | Object |
|---|---|
| Обязательно | Нет |
| Версия манифеста | 2 или выше |
| Пример | "externally_connectable": {
"ids": [
"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"cccccccccccccccccccccccccccccccc"
],
"matches": [
"https://example1.com/*",
"*://*.example2.com/*"
]
} |
Внешне подключаемые элементы управления определяют, с какими другими расширениями и веб-страницами может общаться расширение с помощью runtime.connect() и runtime.sendMessage() механизма обмена сообщениями. Если externally_connectable не указано, все расширения могут общаться друг с другом, но не с веб-страницами.
Примечание: Для связи с веб-страницами:
- В Chrome используются
chrome.runtime.connectиchrome.runtime.sendMessage. Эти методы доступны только тогда, когда по крайней мере одно расширение прослушивает сообщения, см. chrome.runtime больше не будет определяться безусловно в Chrome 106 для получения более подробной информации. - В Safari используются
browser.runtime.connectиbrowser.runtime.sendMessage. - В Firefox ни один из API не поддерживается. См. ошибку Firefox 1319168.
"ids" атрибут
ids позволяет осуществлять связь между этим расширением и другими установленными расширениями, указанными идентификаторами расширений. Используйте шаблон "*" для связи со всеми расширениями.
"matches" атрибут
matches — это список регулярных выражений, который позволяет устанавливать связь между расширением и веб-страницами, соответствующими выражению.
Примечание: Если externally_connectable не указано, общение между расширениями разрешено так, как если бы externally_connectable указало {"ids": ["*"] }. Поэтому, если вы указываете externally_connectable.matches, не забудьте добавить ids если вы хотите общаться с другими расширениями.
Совместимость с браузерами
| Рабочий стол | Мобильная версия | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | |
externally_connectable |
Да | 79 | НетСм. ошибку 1319168. |
? | Да | 15.4Safari поддерживает только свойствоmatches. |
? | ? | Нет | ? | 15.4Safari поддерживает только свойствоmatches. |
? |
© 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/manifest.json/externally_connectable
