(Node.js) Process New Email by Scanning for Senders

Scan email and save application-selected emails to EML files with unique filenames.

Install Chilkat for Node.js and Electron using npm at Chilkat npm packages for Node.js Chilkat npm packages for Electron on Windows, Linux, MacOSX, and ARM

var os = require('os');
if (os.platform() == 'win32') {  
    if (os.arch() == 'ia32') {
        var chilkat = require('@chilkat/ck-node21-win-ia32');
    } else {
        var chilkat = require('@chilkat/ck-node21-win64'); 
    }
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node21-arm');
    } else if (os.arch() == 'x86') {
        var chilkat = require('@chilkat/ck-node21-linux32');
    } else {
        var chilkat = require('@chilkat/ck-node21-linux64');
    }
} else if (os.platform() == 'darwin') {
    if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node21-mac-m1');
    } else {
        var chilkat = require('@chilkat/ck-node21-macosx');
    }
}

function chilkatExample() {

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    var imap = new chilkat.Imap();

    // Connect to an IMAP server.
    // Use TLS
    imap.Ssl = true;
    imap.Port = 993;
    var success = imap.Connect("imap.someMailServer.com");
    if (success !== true) {
        console.log(imap.LastErrorText);
        return;
    }

    // Login
    success = imap.Login("myLogin","myPassword");
    if (success !== true) {
        console.log(imap.LastErrorText);
        return;
    }

    // Select an IMAP mailbox
    success = imap.SelectMailbox("Inbox");
    if (success !== true) {
        console.log(imap.LastErrorText);
        return;
    }

    // messageSet: MessageSet
    var messageSet;
    // We can choose to fetch UIDs or sequence numbers.
    var fetchUids = true;

    // Fetch messages from the mailbox using a search criteria.
    // This example finds NEW emails: these are emails that have the RECENT flag set, but not the SEEN flag:
    messageSet = imap.Search("NEW",fetchUids);
    if (imap.LastMethodSuccess == false) {
        console.log(imap.LastErrorText);
        return;
    }

    // This example will download headers, and then download
    // the full email for those emails sent from a contact
    // in our database.

    // When downloading headers, each email object contains
    // (obviously) the headers, but the body will be missing.
    // Also, attachments will not be included.  However, it is
    // possible to get information about the attachments
    // as well as the complete size of the email.
    // bundle: EmailBundle
    var bundle;
    bundle = imap.FetchHeaders(messageSet);
    if (imap.LastMethodSuccess == false) {

        console.log(imap.LastErrorText);
        return;
    }

    // Loop over the email objects...
    var i = 0;
    var numEmails = bundle.MessageCount;
    while (i < numEmails) {
        // email: Email
        var email = bundle.GetEmail(i);

        // The sender's email address and name are available
        // in the From, FromAddress, and FromName properties.
        // If the sender is "Chilkat Support <support@chilkatsoft.com",
        // then the From property will hold the entire string.
        // the FromName property contains"Chilkat Support",
        // and the FromAddress property contains "support@chilkatsoft.com"
        console.log(email.From);
        console.log(email.FromAddress);
        console.log(email.FromName);

        // Assume at this point your code checks to see if the sender
        // is one in your contacts database.  If so, this is
        // the code you would write to download the entire
        // email and save it to a file.

        // The ckx-imap-uid header field is added when
        // headers are downloaded.  This makes it possible
        // to get the UID from the email object.
        var uidStr = email.GetHeaderField("ckx-imap-uid");
        var uid = uidStr;

        // fullEmail: Email
        var fullEmail;
        fullEmail = imap.FetchSingle(uid,true);
        if (imap.LastMethodSuccess == true) {
            // You may use the GenerateFilename method to
            // generate a unique filename...
            var filename;
            filename = fullEmail.GenerateFilename();

            // SaveEml saves the entire email, including attachments.
            success = fullEmail.SaveEml(filename);

        }

        console.log("--");

        i = i+1;
    }

    // Disconnect from the IMAP server.
    success = imap.Disconnect();


}

chilkatExample();