runtime.MessageSender

メッセージや接続要求の送信元に関する情報を持つオブジェクトです。このオブジェクトは、runtime.onMessage() リスナーに渡されます。

また、このオブジェクトは runtime.Port (en-US) のプロパティでもありますが、runtime.onConnect() (en-US) または runtime.onConnectExternal() (en-US) リスナーに渡された Port インスタンスにしか存在しません。

この型はオブジェクトです。以下のプロパティを持ちます。

tab省略可
tabs.Tab 型。接続を開いた tabs.Tab です。このプロパティが存在するのは、タブ (コンテンツスクリプトを含む) から接続が開かれたときだけです。
frameId省略可
integer 型。接続を開いたフレームです。0 は最上位のフレームを、正の数値は子フレームを表します。このプロパティが存在するのは、tab が設定されるときだけです。
id省略可
string 型。メッセージが拡張機能から送信された場合は、その拡張機能の ID が設定されます。送信側の manifest.json で applications キーを使って明示的に ID が設定されている場合は、id にはその値が使われます。そうでない場合は、送信側の自動生成された ID が使われます。
バージョン 54 より前の Firefox では、この値には拡張機能の内部 ID が使われることに注意してください (つまり、拡張機能の URL に含まれる UUID です)。
url省略可
string 型。メッセージを送信したスクリプトを持つページやフレームの URL です。
送信側が拡張機能のページ (例えば、バックグラウンド ページオプションページブラウザーアクション や ページアクション のポップアップ) に含まれるスクリプトである場合、URL は "moz-extension://<拡張機能の内部 ID>/path/to/page.html" という形式が使われます。送信側がバックグラウンドスクリプトであって、バックグラウンド ページを使っていない場合、URL は "moz-extension://<拡張機能の内部 ID>/_generated_background_page.html" という形式が使われます。
送信側がウェブページ内のスクリプト (ページに含まれる通常のスクリプトだけでなく、コンテンツスクリプトも含みます) である場合、url はそのウェブページの URL が使われます。スクリプトがフレーム内で動作している場合、url はそのフレームの URL です。
tlsChannelId省略可
string 型。接続を開いたページまたはフレームの TLS チャンネルの ID です。拡張機能によって要求され、可能である場合にのみ設定されます。

ブラウザー実装状況

BCD tables only load in the browser

謝辞

この API は Chromium の chrome.runtime API に基づいています。このドキュメントは runtime.json における Chromium のコードに基づいています。

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。