|
| 1 | +================================= |
| 2 | +Changes up to Thunderbird 128 ESR |
| 3 | +================================= |
| 4 | + |
| 5 | +-------------------- |
| 6 | +Thunderbird 117 Beta |
| 7 | +-------------------- |
| 8 | + |
| 9 | +messages API |
| 10 | +============ |
| 11 | +* Added the optional ``data_format`` parameter to :ref:`messages.getRaw` to request the message as a DOM ``File`` object. |
| 12 | + |
| 13 | +-------------------- |
| 14 | +Thunderbird 120 Beta |
| 15 | +-------------------- |
| 16 | + |
| 17 | +messages API |
| 18 | +============ |
| 19 | +* Added :ref:`messages.abortList` to terminate any process currently still adding messages to the given list. |
| 20 | +* Added the ``messagesPerPage`` property to the ``queryInfo`` parameter of :ref:`messages.query`, to allow queries to override the default size of message pages. See :doc:`../examples/messageLists` for more information. |
| 21 | +* Added the ``autoPaginationTimeout`` property to the ``queryInfo`` parameter of :ref:`messages.query`, 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 :ref:`messages.abortList`. |
| 22 | +* Added the ``returnMessageListId`` property to the ``queryInfo`` parameter of :ref:`messages.query`, 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. |
| 23 | +* Extend allowed characters for tag names in :ref:`messages.createTag`, :ref:`messages.updateTag` and :ref:`messages.deleteTag` from alpha-numeric characters only, to all characters excluding ``^ ()/{%*<>"``. |
| 24 | + |
| 25 | +-------------------- |
| 26 | +Thunderbird 121 Beta |
| 27 | +-------------------- |
| 28 | + |
| 29 | +folders API |
| 30 | +=========== |
| 31 | +* Added :ref:`folders.get` to retrieve a folder identified by the given id (the nature of the id will continue to change). |
| 32 | +* Added :ref:`folders.getFolderCapabilities` to retrieve capabilitiy information about a given folder. |
| 33 | +* Added :ref:`folders.markAsRead` to mark all messages in a folder as read. |
| 34 | +* Added :ref:`folders.query` to query for folders with specified properties. |
| 35 | +* Added :ref:`folders.update` to update properties of the given folder. |
| 36 | +* Added the :ref:`folders.onUpdated` event. |
| 37 | +* Added ``isVirtual``, ``isRoot`` and ``isFavorite`` members to the :ref:`folders.MailFolder` type. |
| 38 | +* Added ``lastUsed``, ``newMessageCount`` and ``quota`` members to the :ref:`folders.MailFolderInfo` type. |
| 39 | +* The ``type`` member of the :ref:`folders.MailFolder` type has been deprecated. It was replaced by the array member ``specialUse``, allowing folders to have multiple special uses. |
| 40 | +* The ``favorite`` member of the :ref:`folders.MailFolderInfo` type has been deprecated. It was replaced by the ``isFavorite`` property of the :ref:`folders.MailFolder` type. |
| 41 | + |
| 42 | +mailTabs API |
| 43 | +============ |
| 44 | +* Added :ref:`mailTabs.create`, to create a new mail tab with a specified folder. |
| 45 | +* Added :ref:`mailTabs.getListedMessages`, to retrieve the messages currently being listed in the specified tab, honoring sort order and filters. |
| 46 | + |
| 47 | +messages API |
| 48 | +============ |
| 49 | +* Added the ``accountId``, ``folderId``, ``junk``, ``junkScore``, ``new`` and ``size`` properties to the ``queryInfo`` parameter of :ref:`messages.query`, to query for messages with the given properties. |
| 50 | +* Added the ability to :ref:`messages.query` for a range instead of a fixed value for ``attachment``, ``junkScore`` and ``size``. |
| 51 | +* Added the ``monitorAllFolders`` parameter to the :ref:`messages.onNewMailReceived` event, to allow extensions to listen for new messages in all folders, not just in inbox folders. |
| 52 | + |
| 53 | +messages.tags API |
| 54 | +================= |
| 55 | +All tag related functions have been moved into its own :doc:`/messages.tags`. |
| 56 | + |
| 57 | +* Added :ref:`messages.tags.list` function, to list tags. |
| 58 | +* Added :ref:`messages.tags.create` function, to create new tags. |
| 59 | +* Added :ref:`messages.tags.update` function, to update tags. |
| 60 | +* Added :ref:`messages.tags.delete` function, to delete tags. |
| 61 | + |
| 62 | +The former functions :ref:`messages.listTags`, :ref:`messages.createTag`, :ref:`messages.updateTag` and :ref:`messages.deleteTag` have been deprecated. |
| 63 | + |
| 64 | +tabs API |
| 65 | +======== |
| 66 | +* Allow :ref:`tabs.query` to also provide an array of :ref:`tabs.TabType` for ``queryInfo.type``, for example to find all ``mail`` and ``messageDisplay`` tabs. |
| 67 | + |
| 68 | +-------------------- |
| 69 | +Thunderbird 122 Beta |
| 70 | +-------------------- |
| 71 | + |
| 72 | +menus API |
| 73 | +========= |
| 74 | +* Officially support ``data:`` urls and ``blob:`` urls for menu icons. |
| 75 | + |
| 76 | +messages API |
| 77 | +============ |
| 78 | +* Introduction of the :permission:`messagesUpdate` permission, required for :ref:`messages.update`. |
| 79 | +* Introduction of the :permission:`messagesTagsList` permission, required for :ref:`messages.tags.list`. |
| 80 | + |
| 81 | +-------------------- |
| 82 | +Thunderbird 123 Beta |
| 83 | +-------------------- |
| 84 | + |
| 85 | +messages API |
| 86 | +============ |
| 87 | + |
| 88 | +* Added :ref:`messages.deleteAttachments`, to remove attachments from messages. The new :permission:`messagesModifyPermanent` is required to permanently modify the message content. The content-type of such attachments will be ``text/x-moz-deleted`` |
| 89 | + |
| 90 | +-------------------- |
| 91 | +Thunderbird 124 Beta |
| 92 | +-------------------- |
| 93 | + |
| 94 | +menus API |
| 95 | +========= |
| 96 | +* Officially support remote ``http(s):`` urls for menu icons. |
| 97 | + |
| 98 | +-------------------- |
| 99 | +Thunderbird 125 Beta |
| 100 | +-------------------- |
| 101 | + |
| 102 | +compose API |
| 103 | +=========== |
| 104 | +* Added ``autoSave`` as a possible value of the ``saveInfo.mode`` property of the :ref:`compose.onAfterSave` event. |
| 105 | +* Added ``isModified`` property to :ref:`compose.ComposeDetails`, indicating whether the compose window will ask for confirmation before being closed, because its content has been modified but not yet saved. |
| 106 | + |
| 107 | +messages API |
| 108 | +============ |
| 109 | +* Added an optional ``decrypt`` parameter to :ref:`messages.getFull`, to request the decryption before parsing the message. Defaults to ``true``. |
| 110 | +* Added an optional ``decrypt`` parameter to :ref:`messages.getRaw`, to request the decryption before returning the raw message content. Defaults to ``false``. |
| 111 | +* Added ``decryptionStatus`` property to :ref:`messages.MessagePart` (one of ``none``, ``skipped``, ``success`` or ``fail``). |
| 112 | + |
| 113 | +messengerUtilities API |
| 114 | +====================== |
| 115 | +* Adding a new API with useful helper functions. |
| 116 | +* Added :ref:`messengerUtilities.formatFileSize` to properly format file sizes (for example ``12 bytes`` or ``11,4 GB``). |
| 117 | +* Added :ref:` messengerUtilities.parseMailboxString`, to parse a mailbox string containing one or more email addresses (see RFC 5322, section 3.4). For example `` User1 <[email protected]>, User2 <[email protected]>`` will return an array with two :ref:` messengerUtilities.ParsedMailbox` entries, giving access the the `` name`` and `` email`` part of the provided mailbox strings. |
| 118 | + |
| 119 | +-------------------- |
| 120 | +Thunderbird 126 Beta |
| 121 | +-------------------- |
| 122 | + |
| 123 | +messageDisplayScripts API |
| 124 | +========================= |
| 125 | +* Added support for ``runAt`` to :ref:`messageDisplayScripts.RegisteredMessageDisplayScriptOptions` |
| 126 | + |
| 127 | +-------------------- |
| 128 | +Thunderbird 127 Beta |
| 129 | +-------------------- |
| 130 | + |
| 131 | +folders API |
| 132 | +=========== |
| 133 | +* Added support for ``isTag`` and ``isVirtual`` properties to :ref:`folders.MailFolder`. |
| 134 | +* Added support for ``queryInfo.isTag`` and ``queryInfo.isVirtual`` properties to :ref:`folders.query`. |
| 135 | +* Added :ref:`folders.getUnifiedFolder` to return a specific unified folder (``inbox``, ``trash`` etc.). |
| 136 | +* Added :ref:`folders.getTagFolder` to return a specific tag folder. |
| 137 | + |
| 138 | +mailTabs API |
| 139 | +============ |
| 140 | +* Added ``folderMode`` and ``folderModesEnabled`` properties to :ref:`mailTabs.MailTab` and :ref:`mailTabs.MailTabProperties`. |
| 141 | + |
| 142 | +-------------------- |
| 143 | +Thunderbird 128 Beta |
| 144 | +-------------------- |
| 145 | + |
| 146 | +browserAction API |
| 147 | +======================== |
| 148 | +* Added :ref:`browserAction.getBadgeTextColor`. |
| 149 | +* Added :ref:`browserAction.setBadgeTextColor`. |
| 150 | + |
| 151 | +compose API |
| 152 | +=========== |
| 153 | +* Added ``attachPublicPGPKey`` and ``selectedEncryptionTechnology`` properties to :ref:`compose.ComposeDetails` |
| 154 | + |
| 155 | + |
| 156 | +composeAction API |
| 157 | +======================== |
| 158 | +* Added :ref:`browserAction.getBadgeTextColor`. |
| 159 | +* Added :ref:`browserAction.setBadgeTextColor`. |
| 160 | + |
| 161 | +identities API |
| 162 | +============== |
| 163 | +* Added :ref:`identities.EncryptionCapabilities`, used in the added `encryptionCapabilities` property of :ref:`identities.MailIdentity`. |
| 164 | + |
| 165 | +mailTabs API |
| 166 | +============ |
| 167 | +* Added :ref:`mailTabs.getSelectedFolders` to return the currently selected folders in the folder pane. |
| 168 | + |
| 169 | +menus API |
| 170 | +========= |
| 171 | +* Added ``selectedFolders`` property to :ref:`menus-OnShown` and :ref:`menus.OnClicked`. |
| 172 | + |
| 173 | +messageDisplayAction API |
| 174 | +======================== |
| 175 | +* Added :ref:`messageDisplayAction.getBadgeTextColor`. |
| 176 | +* Added :ref:`messageDisplayAction.setBadgeTextColor`. |
| 177 | + |
| 178 | +messages API |
| 179 | +============ |
| 180 | +* Added :ref:`messages.listInlineTextParts` |
| 181 | + |
| 182 | +messengerUtilities API |
| 183 | +====================== |
| 184 | +* Addded :ref:`messengerUtilities.convertToPlainText` |
0 commit comments