Changelog for Thunderbird 153

The following WebExtension API changes were introduced in Thunderbird 153.

contextualIdentities

api contextualIdentities

• function getSupportedColors — Retrieves the list of colors supported by contextual identities.

• function getSupportedIcons — Retrieves the list of icons supported by contextual identities.

messages

api messages

• function saveMessage — Saves a message programmatically as a draft or as a template in the background without user interaction. The save mode defaults to <value>draft</value>. The returned Promise fulfills once the message has been successfully saved. Throws when there has been an error while saving the message.\n**Note:** If no <value>deliveryFormat</value> is specified, the message is saved as plain text when the body contains no HTML formatting.

• function sendMessage — Sends a message programmatically in the background without user interaction. If the send mode is not specified or set to <value>default</value>, the message will be sent directly if the user is online and placed in the user’s outbox otherwise. The returned Promise fulfills once the message has been successfully sent or placed in the user’s outbox. Throws when there has been an error while sending the message to the outgoing mail server.\n**Note:** If no <value>deliveryFormat</value> is specified, the message is sent as plain text when the body contains no HTML formatting.\n**Note:** It is possible to pass in a compose.ComposeDetails object as the <value>details</value> parameter, and it will be interpreted as a messages.NewMessageDetails object.

• type AttachmentType — The type of an attachment in a message.

• type MessageAttachment.cloudFileUrl — The remote location a cloudFile attachment’s content is stored at. Present for cloudFile attachments (see messages.AttachmentType), whose content is not part of the message.

• type MessageAttachment.linkUrl — The remote location the attachment’s content is linked to. Present for linked attachments (see messages.AttachmentType), whose content is not part of the message and can be fetched from this url.

• type MessageAttachment.type — The type of this attachment.

• type NewMessageDetails — Details of a message to be sent.

messengerSettings

api messengerSettings

• setting composeInlineSpellCheckEnabled — Whether the inline (real-time) spell checker is enabled in the message compose window.

oauthProvider

api oauthProvider

• property oauth_provider.issuerIdentifier — The OAuth authorization server issuer identifier, as defined by RFC 9207. If provided, it must be an exact string match to what the provider gives in the iss field.

• property oauth_provider.useExternalBrowser — If the login flow should use the system web browser. If true, the redirectionEndpoint must be a loopback address, so an origin of http://127.0.0.1 or http://localhost.

runtime

api runtime

• function getDocumentId — Get the documentId of any window global or frame element. Throws for invalid targets, such as unloaded frames.

• type MessageSender.documentId — A UUID of the document that opened the connection.

scripting

api scripting

• type InjectionTarget.documentIds — The IDs of specific documents to inject into. This must not be set if frameIds or allFrames is set.

tabs

api tabs

• function connect.connectInfo.documentId — Open a port to a specific document identified by documentId instead of all frames in the tab.

• function sendMessage.options.documentId — Send a message to a specific document identified by documentId instead of all frames in the tab.

webRequest

api webRequest

• event onAuthRequired.details.documentId — The UUID of the document making the request.

• event onAuthRequired.details.parentDocumentId — The UUID of the parent document owning this frame. This is not set if there is no parent.

• event onBeforeRedirect.details.documentId — The UUID of the document making the request.

• event onBeforeRedirect.details.parentDocumentId — The UUID of the parent document owning this frame. This is not set if there is no parent.

• event onBeforeRequest.details.documentId — The UUID of the document making the request.

• event onBeforeRequest.details.parentDocumentId — The UUID of the parent document owning this frame. This is not set if there is no parent.

• event onBeforeSendHeaders.details.documentId — The UUID of the document making the request.

• event onBeforeSendHeaders.details.parentDocumentId — The UUID of the parent document owning this frame. This is not set if there is no parent.

• event onCompleted.details.documentId — The UUID of the document making the request.

• event onCompleted.details.parentDocumentId — The UUID of the parent document owning this frame. This is not set if there is no parent.

• event onErrorOccurred.details.documentId — The UUID of the document making the request. This value is not present if the request is a navigation of a frame.

• event onErrorOccurred.details.parentDocumentId — The UUID of the parent document owning this frame. This is not set if there is no parent.

• event onHeadersReceived.details.documentId — The UUID of the document making the request.

• event onHeadersReceived.details.parentDocumentId — The UUID of the parent document owning this frame. This is not set if there is no parent.

• event onResponseStarted.details.documentId — The UUID of the document making the request.

• event onResponseStarted.details.parentDocumentId — The UUID of the parent document owning this frame. This is not set if there is no parent.

• event onSendHeaders.details.documentId — The UUID of the document making the request.

• event onSendHeaders.details.parentDocumentId — The UUID of the parent document owning this frame. This is not set if there is no parent.