Changes up to Thunderbird 121 Beta

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.

Thunderbird 121 Beta

accounts API

• Removed the deprecated function accounts.getDefaultIdentity().

• Removed the deprecated function accounts.setDefaultIdentity().

folders API

The folders API has been changed to use a MailFolderId instead of MailFolder, to specify a folder. The nature of the id will change in a future release.

• Added get(folder, [includeSubFolders]) to retrieve a folder identified by the given MailFolderId.

• 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.

• The displayedFolder property of the MailTabProperties parameter used in various functions needs to use a MailFolderId instead of MailFolder, to specify a folder.

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.

• The functions list(folder), move(messageIds, destination), copy(messageIds, destination) and import(file, destination, [properties]) need to use a MailFolderId instead of MailFolder, to specify a folder.

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 messages.listTags(), messages.createTag(), messages.updateTag() and messages.deleteTag() have been removed.