≡ messengerSettings API

• Permissions

• Properties

≡ Add-on developer resources

• Introduction to add-on development

• "Hello world" extension tutorial

• Developer community

• Sample extensions (Github)

• Using Promises

• Additional resources on DTN

≡ Guides

• Working with WebExtension events

• Working with message lists

• Working with vCard contacts

messengerSettings API

The messengerSettings API allows to access global messenger settings.

Permissions

The following permissions influence the behavior of the API. Depending on which permissions are requested, additional methods might be available, or certain data may be included in responses.

Hint

Request permissions only when needed. Unnecessary requests may result in rejection during ATN review.

messengerSettings

messengerSettings

Read Thunderbird settings.

Note

The permission messengerSettings is required to use messenger.messengerSettings.*.

Properties

messageLineLengthLimit

The line length limit for outgoing messages, to comply with requirements from RFC 2822. See description of messagePlainTextFlowedOutputEnabled.

messagePlainTextFlowedOutputEnabled

Whether long lines in outgoing plain text messages will get soft line breaks (​ \n) or hard line breaks (\n), to comply with requirements from RFC 2822. Soft line breaks will be ignored when displayed by the receiving client. When flowed output is enabled, add-ons should not create plain text messages with manually inserted hard or soft line breaks to achieve a certain text width, as that will most probably interfere with the default line break handling and generate ridged text. When flowed output is disabled, add-ons could add hard line breaks to have control over the final message, but any line longer than the maximum line length will still receive additional hard line breaks. See messageLineLengthLimit.