runtime.MessageSender

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

また、このオブジェクトは runtime.Port のプロパティでもありますが、runtime.onConnect() または runtime.onConnectExternal() リスナーに渡された 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 です。拡張機能によって要求され、可能である場合にのみ設定されます。

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
MessageSender
documentId
documentLifecycle
frameId
id
origin
tab
tlsChannelId
url

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

メモ: この API は Chromium の chrome.runtime API に基づいています。このドキュメントは runtime.json における Chromium のコードに基づいています。Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。