Changes up to Thunderbird 128 ESR

Thunderbird 117 Beta

messages API

• Added the optional data_format parameter to getRaw(messageId, [options]) to request the message as a DOM File object.

Thunderbird 120 Beta

messages API

• Added abortList(messageListId) to terminate any process currently still adding messages to the given list.

• Added the messagesPerPage property to the queryInfo parameter of query([queryInfo]), to allow queries to override the default size of message pages. See Working with message lists for more information.

• Added the autoPaginationTimeout property to the queryInfo parameter of query([queryInfo]), to allow queries to override the default pagination timeout of 1000ms. Long running queries will return pages even if they have not reached the nominal page size, to allow extensions to work with the already received results or terminate the list (and the associated query) using abortList(messageListId).

• Added the returnMessageListId property to the queryInfo parameter of query([queryInfo]), to force queries to immediately return the id of the list associated with the query, instead of waiting for at least one found message and returning the first page.

• Extend allowed characters for tag names in createTag(key, tag, color), updateTag(key, updateProperties) and deleteTag(key) from alpha-numeric characters only, to all characters excluding ^ ()/{%*<>".

Thunderbird 121 Beta

folders API

• Added get(folderId, [includeSubFolders]) to retrieve a folder identified by the given id (the nature of the id will continue to change).

• Added getFolderCapabilities(folder) to retrieve capabilitiy information about a given folder.

• Added markAsRead(folder) to mark all messages in a folder as read.

• Added query([queryInfo]) to query for folders with specified properties.

• Added update(folder, updateProperties) to update properties of the given folder.

• Added the onUpdated event.

• Added isVirtual, isRoot and isFavorite members to the MailFolder type.

• Added lastUsed, newMessageCount and quota members to the MailFolderInfo type.

• The type member of the MailFolder type has been deprecated. It was replaced by the array member specialUse, allowing folders to have multiple special uses.

• The favorite member of the MailFolderInfo type has been deprecated. It was replaced by the isFavorite property of the MailFolder type.

mailTabs API

• Added create([createProperties]), to create a new mail tab with a specified folder.

• Added getListedMessages([tabId]), to retrieve the messages currently being listed in the specified tab, honoring sort order and filters.

messages API

• Added the accountId, folderId, junk, junkScore, new and size properties to the queryInfo parameter of query([queryInfo]), to query for messages with the given properties.

• Added the ability to query([queryInfo]) for a range instead of a fixed value for attachment, junkScore and size.

• Added the monitorAllFolders parameter to the onNewMailReceived event, to allow extensions to listen for new messages in all folders, not just in inbox folders.

messages.tags API

All tag related functions have been moved into its own messages.tags API.

• Added list() function, to list tags.

• Added create(key, tag, color) function, to create new tags.

• Added update(key, updateProperties) function, to update tags.

• Added delete(key) function, to delete tags.

The former functions listTags(), createTag(key, tag, color), updateTag(key, updateProperties) and deleteTag(key) have been deprecated.

tabs API

• Allow query([queryInfo]) to also provide an array of TabType for queryInfo.type, for example to find all mail and messageDisplay tabs.

Thunderbird 122 Beta

menus API

• Officially support data: urls and blob: urls for menu icons.

messages API

• Introduction of the messagesUpdate permission, required for update(messageId, newProperties).

• Introduction of the messagesTagsList permission, required for list().

Thunderbird 123 Beta

messages API

• Added deleteAttachments(messageId, partNames), to remove attachments from messages. The new messagesModifyPermanent is required to permanently modify the message content. The content-type of such attachments will be text/x-moz-deleted

Thunderbird 124 Beta

menus API

• Officially support remote http(s): urls for menu icons.

Thunderbird 125 Beta

compose API

• Added autoSave as a possible value of the saveInfo.mode property of the onAfterSave event.

• Added isModified property to ComposeDetails, indicating whether the compose window will ask for confirmation before being closed, because its content has been modified but not yet saved.

messages API

• Added an optional decrypt parameter to getFull(messageId, [options]), to request the decryption before parsing the message. Defaults to true.

• Added an optional decrypt parameter to getRaw(messageId, [options]), to request the decryption before returning the raw message content. Defaults to false.

• Added decryptionStatus property to MessagePart (one of none, skipped, success or fail).

messengerUtilities API

• Adding a new API with useful helper functions.

• Added formatFileSize(sizeInBytes) to properly format file sizes (for example 12 bytes or 11,4 GB).

• Added parseMailboxString(mailboxString, [preserveGroups]), to parse a mailbox string containing one or more email addresses (see RFC 5322, section 3.4). For example User1 <user1@inter.net>, User2 <user2@inter.net> will return an array with two ParsedMailbox entries, giving access to the name and email part of the provided mailbox strings.

Thunderbird 126 Beta

messageDisplayScripts API

• Added support for runAt to RegisteredMessageDisplayScriptOptions

Thunderbird 127 Beta

folders API

• Added support for isTag and isVirtual properties to MailFolder.

• Added support for queryInfo.isTag and queryInfo.isVirtual properties to query([queryInfo]).

• Added getUnifiedFolder(type, [includeSubFolders]) to return a specific unified folder (inbox, trash etc.).

• Added getTagFolder(key) to return a specific tag folder.

mailTabs API

• Added folderMode and folderModesEnabled properties to MailTab and MailTabProperties.

Thunderbird 128.0 ESR

browserAction API

• Added getBadgeTextColor(details).

• Added setBadgeTextColor(details).

compose API

• Added attachPublicPGPKey and selectedEncryptionTechnology properties to ComposeDetails

composeAction API

• Added getBadgeTextColor(details).

• Added setBadgeTextColor(details).

identities API

• Added EncryptionCapabilities, used in the added encryptionCapabilities property of MailIdentity.

mailTabs API

• Added getSelectedFolders([tabId]) to return the currently selected folders in the folder pane.

menus API

• Added selectedFolders property to onShown and onClicked.

messageDisplayAction API

• Added getBadgeTextColor(details).

• Added setBadgeTextColor(details).

messages API

• Added listInlineTextParts(messageId)

messengerUtilities API

• Addded convertToPlainText(body, [options])