runtime.MessageSender

Объект, содержащий информацию об отправителе сообщения или запроса подключения; он передаётся слушателю runtime.onMessage().

Он также является свойством runtime.Port, но только в экземпляре Port, переданном в слушатели runtime.onConnect() или runtime.onConnectExternal().

Тип

Значения этого типа — объекты. Они содержат следующие свойства:

tab Необязательно

tabs.Tab. tabs.Tab, который открыл подключение. Это свойство будет присутствовать только тогда, когда подключение было открыто из вкладки (включая скрипты содержимого).

frameId Необязательно

integer. Фрейм, который открыл подключение. Ноль для фреймов верхнего уровня, положительное значение для дочерних фреймов. Это свойство будет установлено только тогда, когда tab установлено.

id Необязательно

string. Идентификатор расширения, отправившего сообщение, если сообщение было отправлено расширением. Если отправитель явно установил идентификатор, используя ключ browser_specific_settings в manifest.json, то id будет содержать это значение. В противном случае он будет содержать идентификатор, сгенерированный для отправителя.

url Необязательно

string. URL страницы или фрейма, содержащего скрипт, отправивший сообщение.

Если отправителем является скрипт, работающий на странице расширения (например, страница фона, страница настроек или всплывающее окно действия браузера или действия страницы), URL будет в формате "moz-extension://<extension-internal-id>/path/to/page.html". Если отправителем является скрипт фона, и вы не включили страницу фона, он будет "moz-extension://<extension-internal-id>/_generated_background_page.html".

>Если отправителем является скрипт, работающий на веб-странице (включая скрипты содержимого и обычные скрипты страницы), то url будет URL веб-страницы. Если скрипт работает во фрейме iframe, url будет URL фрейма iframe.

tlsChannelId Необязательно

string. Идентификатор канала TLS страницы или фрейма, открывшего подключение, если это запрошено расширением и доступно.

Совместимость с браузерами

	Рабочий стол						Мобильный
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`MessageSender`	26	14	45 До версии 54, 'id' был внутренним UUID дополнения, а не идентификатором дополнения.	?	15	14	?	?	48 До версии 54, 'id' был внутренним UUID дополнения, а не идентификатором дополнения.	?	15	?
`frameId`	41	14	45	?	28	14	?	?	48	?	15	?
`tlsChannelId`	32	79	45	?	19	Нет	?	?	48	?	Нет	?
`url`	28	14 `url` отсутствует, когда сообщение было отправлено представлением расширения.	45	?	15	14	?	?	48	?	15	?

Примечание: Этот API основан на API chrome.runtime от Chromium. Данная документация взята из runtime.json кода Chromium.

© 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/API/runtime/MessageSender