当前位置：文江博客知识库 en-US 文档 Mozilla Chat_Core Notifications

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	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	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	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	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