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 DOMFile
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 thequeryInfo
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 thequeryInfo
parameter of query([queryInfo]), to allow queries to override the default pagination timeout of1000ms
. 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 thequeryInfo
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
folders API
Added get(folder, [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
andisFavorite
members to the MailFolder type.Added
lastUsed
,newMessageCount
andquota
members to the MailFolderInfo type.The
type
member of the MailFolder type has been deprecated. It was replaced by the array memberspecialUse
, allowing folders to have multiple special uses.The
favorite
member of the MailFolderInfo type has been deprecated. It was replaced by theisFavorite
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
andsize
properties to thequeryInfo
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
andsize
.Added the
monitorAllFolders
parameter to the onNewMailReceived event, to allow extensions to listen for new messages in all folders, not just in inbox folders.