Revision control
Copy as Markdown
Other Tools
/* -*- indent-tabs-mode: nil; js-indent-level: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
var EXPORTED_SYMBOLS = ["MailUtils"];
var { MailServices } = ChromeUtils.import(
);
/**
* This module has several utility functions for use by both core and
* third-party code. Some functions are aimed at code that doesn't have a
* window context, while others can be used anywhere.
*/
var MailUtils =
{
/**
* Discover all folders. This is useful during startup, when you have code
* that deals with folders and that executes before the main 3pane window is
* open (the folder tree wouldn't have been initialized yet).
*/
discoverFolders: function MailUtils_discoverFolders()
{
for (let server of MailServices.accounts.allServers) {
// why, but catch it and log the fact.
try {
server.rootFolder.subFolders;
}
catch (ex) {
Services.console.logStringMessage("Discovering folders for account failed with " +
"exception: " + ex);
}
}
},
/**
* Get the nsIMsgFolder corresponding to this URI. This uses the RDF service
* to do the work.
*
* @param aFolderURI the URI to convert into a folder
* @param aCheckFolderAttributes whether to check that the folder either has
* a parent or isn't a server
* @returns the nsIMsgFolder corresponding to this URI, or null if
* aCheckFolderAttributes is true and the folder doesn't have a
* parent or is a server
*/
getFolderForURI: function MailUtils_getFolderForURI(aFolderURI,
aCheckFolderAttributes)
{
let folder = null;
let rdfService = Cc['@mozilla.org/rdf/rdf-service;1']
.getService(Ci.nsIRDFService);
folder = rdfService.GetResource(aFolderURI);
// This is going to QI the folder to an nsIMsgFolder as well
if (folder && folder instanceof Ci.nsIMsgFolder)
{
if (aCheckFolderAttributes && !(folder.parent || folder.isServer))
return null;
}
else
{
return null;
}
return folder;
},
/**
* Displays this message in a new window.
*
* @param aMsgHdr the message header to display
*/
displayMessage: function MailUtils_displayMessage(aMsgHdr)
{
this.openMessageInNewWindow(aMsgHdr);
},
/**
* Open a new standalone message window with this header.
*
* @param aMsgHdr the message header to display
*/
openMessageInNewWindow: function MailUtils_openMessageInNewWindow(aMsgHdr)
{
// Pass in the message URI as messageWindow.js doesn't handle message headers
let messageURI = Cc["@mozilla.org/supports-string;1"]
.createInstance(Ci.nsISupportsString);
messageURI.data = aMsgHdr.folder.getUriForMsg(aMsgHdr);
Services.ww.openWindow(null,
"_blank",
"all,chrome,dialog=no,status,toolbar",
messageURI);
}
};