Draft: This page is not complete.
This is a page for documenting the notifications in Instantbird and Thunderbird. This is likely out of date. Notifications are grouped by interface you need to attach the observer to.
nsIObserverService
| Topic | Subject | Data | Added | Removed | Comment |
|---|---|---|---|---|---|
| account-added | imIAccount | null | <1.0 | a new account has been created | |
| account-connected | imIAccount | null | <1.0 | the account has connected | |
| account-connecting | imIAccount | null | <1.0 | the account has started a connection attempt | |
| account-connect-error | imIAccount | null | <1.0 | the account has disconnecting with an error | |
| account-connect-progress | imIAccount | null | <1.0 | the account is attempting to connect | |
| account-disconnected | imIAccount | null | <1.0 | the account has disconnected | |
| account-disconnecting | imIAccount | null | <1.0 | the account is disconnecting without an error reason | |
| account-list-updated | imIAccountsService | null | <1.0 | the list of accounts has been updated | |
| account-removed | imIAccount | null | <1.0 | an account is about to be removed | |
| account-updated | imIAccount | null | <1.0 | ||
| app-handler-pane-loaded | nsIDOMWindow | null | <1.0 | Applications pane in preferences window is loaded | |
| autologin-processed | imICoreService | null | <1.0 | imICoreService::processAutoLogin() is complete | |
| browser-request | prplIRequestBrowser | null | <1.0 | Used by protocol plugins to bring up a browser window (e.g. for an OAuth request) | |
| closing-conversation | prplIConversation | null | <1.0 | ||
| contact-moved | imIContactsService imIContact |
null | <1.0 | when a contact has been moved (removed from one tag, added to another, or both) | |
| contact-tag-added | imIContact | tag.id | <1.0 | when a tag is added to a contact | |
| contact-tag-removed | imIContact | tag.id | <1.0 | when a tag is removed from a contact | |
| conversation-closed | prplIConversation | null | <1.0 | conversation going away | |
| conversation-left-chat | prplIConversation | null | <1.0 | the user has left the conversation (but it might remain visible) | |
| conversation-loaded | nsISupports | null or details | <1.0 | subject is a <browser type="content-conversation">, if fired because an existing conversation is moved from one window to another, the data parameter ("details") will contain the string "imported". | |
| im-sent | prplIConversation | message text | <1.0 | on sending an IM (whether or not it succeeded) | |
| new-text | purpleMessage | null | <1.0 | 1.2 | A new message will be written to a conversation. This can be an incoming, outgoing or system message. |
| new-conversation | prplIConversation | null | <1.0 | conversation created | |
| new-ui-conversation | imIConversation | null | <1.0 | ||
| prpl-quit | imICoreService | null | 1.2 | Core shutdown, was previously purple-quit | |
| status-changed | imICoreService | status text | <1.0 | user (not buddy) status change | |
| tag-hidden | imITag | null | <1.0 | fired when a tag is hidden | |
| tag-shown | imITag | null | <1.0 | fired when a tag is set to be shown (unhiding it) | |
| ui-conversation-closed | null | <1.0 | |||
| unread-im-count-changed | null | count of unread messages | <1.0 | fired when the number of unread messages changes |
imIBuddy
| Topic | Subject | Data | Added | Removed | Notes |
|---|---|---|---|---|---|
| account-buddy-availability-changed | prplIAccountBuddy | null | <1.0 | Possibly fired on account buddy status change | |
| account-buddy-display-name-changed | imIContactsService imIAccountBuddy |
old serverAlias | <1.0 | Fired when setting imIAccountBuddy::serverAlias | |
| account-buddy-icon-changed | imIAccountBuddy | null | <1.0 | Fired when setting imIAccountBuddy::buddyIconFilename | |
| account-buddy-signed-off | imIAccountBuddy | null | <1.0 | Possibly fired on account buddy status change | |
| account-buddy-signed-on | imIAccountBuddy | null | <1.0 | Possibly fired on account buddy status change | |
| account-buddy-status-changed | imIAccountBuddy | null | <1.0 | Possibly fired on account buddy status change | |
| buddy-added | imIBuddy | null | <1.0 | In response to account-buddy-added if the buddy previously had no account buddies | |
| buddy-availability-changed | imIBuddy | null | <1.0 | possibly fired on imIBuddy status updates | |
| buddy-display-name-changed | imIBuddy | old serverAlias | <1.0 | possibly in response to account-buddy-display-name-changed on the preferred account | |
| buddy-preferred-account-changed | imIContactsService imIBuddy |
null | <1.0 | when setting imIBuddy::preferredAccountBuddy (internally) | |
| buddy-removed | imIBuddy | null | <1.0 | In response to account-buddy-removed if the buddy no longer has any account buddies | |
| buddy-signed-off | imIBuddy | null | <1.0 | possibly fired on imIBuddy status updates | |
| buddy-signed-on | imIBuddy | null | <1.0 | possibly fired on imIBuddy status updates | |
| buddy-status-changed | imIBuddy | null | <1.0 | possibly fired on imIBuddy status updates |
imIContact
Note: all imIContact notifications also go to any imITag it belongs to, as well as nsIObserverService.
| Topic | Subject | Data | Added | Removed | Notes |
|---|---|---|---|---|---|
| contact-added | imIContact | null | <1.0 | When a new buddy is created with no other contact | |
| contact-availability-changed | imIContact | null | <1.0 | Possibly fired on contact status updates | |
| contact-display-name-changed | imIContact | null | <1.0 | Fired on setting imIContact::Alias or imIContact::preferredBuddy, or the preferred buddy's display name changed | |
| contact-no-longer-dummy | imIContact | null | <1.0 | Fired when a contact is being loaded? | |
| contact-preferred-buddy-changed | imIContact | null | <1.0 | Fired on setting imIContact::preferredBuddy | |
| contact-removed | imIContact | null | <1.0 | When the last buddy for the contact is removed | |
| contact-signed-off | imIContact | null | <1.0 | Possibly fired on contact status updates | |
| contact-signed-on | imIContact | null | <1.0 | Possibly fired on contact status updates | |
| contact-status-changed | imIContact | null | <1.0 | Possibly fired on contact status updates |
imITag
| Topic | Subject | Data | Added | Removed | Notes |
|---|---|---|---|---|---|
| contact-moved-in | imIContact | null | <1.0 | When a contact has been moved into the tag | |
| contact-moved-out | imIContact | null | <1.0 | When a contact has been moved out of the tag | |
| tag-hidden | imIContact | null | <1.0 | fired when a tag is hidden | |
| tag-shown | imIContact | null | <1.0 | fired when a tag is set to be shown (unhiding it) |
prplIConversation
| Topic | Subject | Data | Added | Removed | Notes |
|---|---|---|---|---|---|
| chat-buddy-add | nsISimpleEnumerator | null | <1.0 | When users join a chat. The enumerator elements are prplIConvChatBuddy. | |
| chat-buddy-removed | nsISimpleEnumerator | null | <1.0 | When chat buddies leave a chat. The enumerator elements are nsISupportsString of the user name. | |
| chat-buddy-update | prplIConvChatBuddy | old name, if the chat buddy is being renamed | <1.0 | data is null if this is not a rename | |
| chat-buddy-topic | null | null | <1.0 | The chat topic was updated | |
| new-text | prplIMessage | null | <1.0 | A new message will be written to a conversation. This can be an incoming, outgoing or system message. Subject was purpleIMessage until 1.2. | |
| update-buddy-status | null | null | <1.0 | away-ness or online/offline | |
| update-conv-chatleft | null | null | <1.0 | the user has left the chat (it might remain visible) | |
| update-conv-title | null | null | <1.0 | ||
| update-typing | null | null | <1.0 |