Notifications

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    

 

Document Tags and Contributors

Tags: 
 Contributors to this page: jswisher, clokep
 Last updated by: jswisher,