(Node.js) Async Upload (Append) Email to an IMAP Mailbox

Use the AppendMailAsync method call to append an email to an IMAP mailbox.

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

    // Login
    success = imap.Login("MY-IMAP-LOGIN","MY-IMAP-PASSWORD");
    if (success !== true) {
        console.log(imap.LastErrorText);
        return;
    }

    // Create a simple email with 2 recipients.
    var email = new chilkat.Email();
    email.From = "support@chilkatsoft.com";
    email.AddTo("Chilkat Sales","sales@chilkatsoft.com");
    email.AddTo("Chilkat GMail","chilkat.support@gmail.com");
    email.Body = "This is a test email.";
    email.Subject = "This is a test email.";

    // Imagine we've sent this email via SMTP, and now we want to 
    // save the email to our "Sent" mailbox.  On GMail, the mailbox name
    // for sent email is "[Gmail]/Sent Mail".

    // Call the async version of the AppendMail method to return a task object.
    // task: Task
    var task = imap.AppendMailAsync("[Gmail]/Sent Mail",email);
    if (imap.LastMethodSuccess !== true) {
        console.log(imap.LastErrorText);
        return;
    }

    // Schedule the task for running on the thread pool.  This changes the task's state
    // from Inert to Live.  The task is now running...
    success = task.Run();
    if (success !== true) {
        console.log(task.LastErrorText);

        return;
    }

    // -------------------------------------------------------------------------------
    // The following is a general note that applies to all programming languages:
    // -------------------------------------------------------------------------------
    // Your application can keep a reference to the task object and periodically check back later to see if it's finished.
    // If your programming language is one that supports callbacks, then the TaskCompleted callback can
    // be setup to be called when the task completes.  (See the "Async" category on example-code.com for more information.)
    // 
    // NOTE: This is very important:  A TaskCompleted callback runs in the background thread.  
    // (All callbacks from an async task, such as AbortCheck, PercentDone, ProgressInfo, etc. are in the background thread.) 
    // An application that uses TaskCompleted must be very careful.  
    // For example, user interface elements (such as labels, text boxes, etc.) may not be directly
    // accessible from a background thread, and could crash the application if directly accessed.  Also, attempting to debug
    // code running in a background thread from an IDE, especially an older IDE (such as VB6) is likely to crash the IDE.

}

chilkatExample();