(Node.js) IMAP STARTTLS (Explicit TLS/SSL)

The StartTls property is set to force the Connect method to automatically convert an connection to TLS/SSL via the STARTTLS IMAP command.

This is also known as "explicit TLS/SSL" as opposed to "implicit TLS/SSL". With implicit TLS/SSL, the IMAP client connects on the well-known IMAP TLS/SSL port 993 and the secure channel is immediately established. With explicit TLS/SSL, the IMAP client connects on the typical non-secure port (143 usually) and the converts the connection via the STARTTLS command.

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();

    // Indicate that STARTTLS should be used to convert
    // to a secure TLS/SSL connection:
    imap.StartTls = true;
    imap.Port = 143;

    // Connect to an IMAP server and convert the connection
    // to TLS/SSL via STARTTLS.
    var success = imap.Connect("imap.someMailServer.com");
    if (success !== true) {
        console.log(imap.LastErrorText);
        return;
    }

    // The remainder of this example is the same as for 
    // non-TLS/SSL...

    // 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;
    // Get the message IDs of all the emails in the mailbox
    messageSet = imap.Search("ALL",fetchUids);
    if (imap.LastMethodSuccess == false) {
        console.log(imap.LastErrorText);
        return;
    }

    // Fetch the emails into a bundle object:
    // bundle: EmailBundle
    var bundle;
    bundle = imap.FetchBundle(messageSet);
    if (imap.LastMethodSuccess == false) {

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

    // Loop over the bundle and display the FROM and SUBJECT of each.
    var i = 0;
    var numEmails = bundle.MessageCount;
    while (i < numEmails) {
        // email: Email
        var email = bundle.GetEmail(i);
        console.log(email.From);
        console.log(email.Subject);
        console.log("--");

        i = i+1;
    }

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


}

chilkatExample();