MDN self-hosted library · e01.org

runtime.MessageSender

An object containing information about the sender of a message or connection request that is passed to the runtime.onMessage() listener.

no runnable cells webextension-api-type upstream source

An object containing information about the sender of a message or connection request that is passed to the runtime.onMessage() listener.

Available for:

  • connections in the runtime.onConnect, runtime.onConnectExternal, and runtime.onUserScriptConnect listeners. In the runtime.onConnect() and runtime.onConnectExternal() listeners, it's a property of the port argument (runtime.Port).
  • messages in runtime.onMessage, runtime.onMessageExternal, and runtime.onUserScriptMessage listeners.

Type

Values of this type are objects. They contain the following properties:

  • documentId
  • : string. A UUID of the document that opened the connection. See the Work with documentId article for more information.
  • documentLifecycle
  • : string. The lifecycle state the document that opened the connection was in when the port was created. Note that the lifecycle state of the document may have changed since the port was created.
  • frameId
  • : integer. The frame that opened the connection. Zero for top-level frames, positive for child frames. This is only set when tab is set.
  • id
  • : string. The ID of the extension that sent the message, if the message was sent by an extension. If the sender has an ID explicitly set using the browser_specific_settings key in manifest.json, then id has this value. Otherwise, it has the ID that was generated for the sender.
  • origin
  • : string. The origin of the page or frame that opened the connection. It can differ from the url property (e.g., about:blank) or be opaque (e.g., sandboxed iframes). This is useful for identifying if the origin can be trusted if it isn't apparent from the URL.
  • tab
  • : tabs.Tab. The tabs.Tab which opened the connection. This property is only present when the connection was opened from a tab (including content scripts).
  • tlsChannelId
  • : string. The TLS channel ID of the page or frame that opened the connection, if requested by the extension and available.
  • url
  • : string. The URL of the page or frame hosting the script that sent the message.

    If the sender is a script running in an extension page (such as a background page, an options page, or a browser action or page action popup), the URL is in the form "moz-extension://<extension-internal-id>/path/to/page.html". If the sender is a background script and you haven't included a background page, it is "moz-extension://<extension-internal-id>/_generated_background_page.html".

    If the sender is a script running in a web page (including content and normal page scripts), then url is the web page URL. If the script is running in an iframe, url is the iframe's URL.

  • userScriptWorldId

  • : string. The worldId of the USER_SCRIPT world that sent the message. Only present in runtime.onUserScriptMessage and in port.sender for runtime.onUserScriptConnect.
  • windowId
  • : integer. The ID of the window that contains the sender. Unlike Tab, it can also be set for senders not in a tab, such as a popup or sidebar. It is absent when the sender has no window, such as a background page.

Browser compatibility

[!NOTE] This API is based on Chromium's chrome.runtime API. This documentation is derived from runtime.json in the Chromium code.