(Node.js) Fetch Single Email by UID or Sequence Number

Assuming the UID is known, download a single email by UID from an IMAP mail server.

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 requires 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("***","***");
    if (success !== true) {
        console.log(imap.LastErrorText);
        return;
    }

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

    // email: Email
    var email;

    var uid = 2014;
    var isUid = true;

    email = imap.FetchSingle(uid,isUid);
    if (imap.LastMethodSuccess == true) {

        // Display the From and Subject
        console.log(email.FromAddress);
        console.log(email.Subject);

        // Display the Body property, which is the default body.
        // If an email has an HTML body, the Body property contains
        // the HTML source.  Otherwise it contains the plain-text
        // body.
        console.log("---- EMAIL BODY ----");
        console.log(email.Body);
        console.log("--------------------");

        // Display the recipients:
        var j;
        for (j = 0; j <= email.NumTo - 1; j++) {
            console.log(email.GetToName(j) + ", " + email.GetToAddr(j));
        }

        for (j = 0; j <= email.NumCC - 1; j++) {
            console.log(email.GetCcName(j) + ", " + email.GetCcAddr(j));
        }

        // Show the total size of the email, including body and attachments:
        console.log(email.Size);

        // When a full email is downloaded, we would use the
        // email.NumAttachments property in conjunction with the
        // email.GetMailAttach* methods.
        // However, when an email object contains only the header,
        // we need to access the attachment info differently:
        var numAttach = imap.GetMailNumAttach(email);
        console.log(numAttach);

        for (j = 0; j <= numAttach - 1; j++) {
            console.log(imap.GetMailAttachFilename(email,j));
            var attachSize = imap.GetMailAttachSize(email,j);
            console.log("    size = " + attachSize + " bytes");
        }

        console.log("--");

    }

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

}

chilkatExample();