≡ scripting.messageDisplay API
.. rst-class:: api-main-section
.. api-member:: :name: :permission:`sensitiveDataUpload` Transfer sensitive user data (if access has been granted) to a remote server for further processing
.. rst-class:: api-permission-info
Note
The permission messagesRead is required to use messenger.scripting.messageDisplay.*.
.. rst-class:: api-main-section
.. api-section-annotation-hack::
Returns all registered message display scripts for this extension that match the given filter.
.. api-header::
:label: Parameters
.. api-member::
:name: [``filter``]
:type: (:ref:`scripting.messageDisplay.MessageDisplayScriptFilter`, optional)
An object to filter the extension's registered message display scripts.
.. api-header::
:label: Return type (`Promise`_)
.. api-member::
:type: array of :ref:`scripting.messageDisplay.MessageDisplayScriptDetails`
.. _Promise: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise
.. api-header:: :label: Required permissions - :permission:`messagesRead`
.. api-section-annotation-hack::
Registers one or more message display scripts for this extension, which should be injected into displayed messages. Note: Registered scripts will only be applied to newly opened messages. To apply the script to already open messages, manually inject your script by calling :ref:`scripting.executeScript` for each of the open messageDisplay tabs.
.. api-header::
:label: Parameters
.. api-member::
:name: ``scripts``
:type: (array of :ref:`scripting.messageDisplay.MessageDisplayScriptDetails`)
Contains a list of message display scripts to be registered. If there are errors during script parsing/file validation, or if the IDs specified already exist, then no scripts are registered.
.. api-header:: :label: Required permissions - :permission:`messagesRead`
.. api-section-annotation-hack::
Unregisters one or more message display scripts for this extension.
.. api-header::
:label: Parameters
.. api-member::
:name: [``filter``]
:type: (:ref:`scripting.messageDisplay.MessageDisplayScriptFilter`, optional)
If specified, only unregisters message display scripts which match the filter. Otherwise, all of the extension's message display scripts are unregistered.
.. api-header:: :label: Required permissions - :permission:`messagesRead`
.. rst-class:: api-main-section
.. api-section-annotation-hack::
.. api-header::
:label: object
.. api-member::
:name: ``id``
:type: (string)
The id of the message display script, specified in the API call.
.. api-member::
:name: [``css``]
:type: (array of :ref:`scripting.messageDisplay.ExtensionURL`, optional)
The list of CSS files to be injected. These are injected in the order they appear in this array.
.. api-member::
:name: [``js``]
:type: (array of :ref:`scripting.messageDisplay.ExtensionURL`, optional)
The list of JavaScript files to be injected. These are injected in the order they appear in this array.
.. api-member::
:name: [``runAt``]
:type: (`RunAt <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/extensionTypes/RunAt>`__, optional)
Specifies when JavaScript files are injected. The preferred and default value is :code:`document_idle`.
.. api-section-annotation-hack::
.. api-header::
:label: object
.. api-member::
:name: [``ids``]
:type: (array of string, optional)
The IDs of specific message display scripts to retrieve with :code:`getRegisteredScripts()` or to unregister with :code:`unregisterScripts()`.
.. rst-class:: api-main-section
The following types are not defined by this API, but by the underlying Mozilla WebExtension code base. They are included here, because there is no other public documentation available.
.. api-section-annotation-hack::
A path relative to the root of the extension.
.. api-header:: :label: string