(Node.js) IMAP Delete Old Email (before a specified date)

Demonstrates how to delete email older than a particular date.

Note: This example requires Chilkat v11.0.0 or greater.

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

var os = require('os');
if (os.platform() == 'win32') {  
  var chilkat = require('@chilkat/ck-node23-win64'); 
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node23-linux-arm');
    } else if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node23-linux-arm64');
    } else {
        var chilkat = require('@chilkat/ck-node23-linux-x64');
    }
} else if (os.platform() == 'darwin') {
  var chilkat = require('@chilkat/ck-node23-mac-universal');
}

function chilkatExample() {

    var success = false;

    // 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;
    // Use your IMAP server domain.  This example 
    success = imap.Connect("imap.example.com");
    if (success == false) {
        console.log(imap.LastErrorText);
        return;
    }

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

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

    // Get message ID's for emails older than 1/1/2025
    var fetchUids = true;
    var messageSet = new chilkat.MessageSet();
    success = imap.QueryMbx("SENTBEFORE 01-Jan-2025",fetchUids,messageSet);
    if (success == false) {
        console.log(imap.LastErrorText);
        return;
    }

    // If desired, we can examine the Subject of each email to be deleted..
    var email = new chilkat.Email();
    var i = 0;
    var count = messageSet.Count;
    var headerOnly = true;

    while (i < count) {
        success = imap.FetchEmail(headerOnly,messageSet.GetId(i),true,email);
        if (success == false) {
            console.log(imap.LastErrorText);
            return;
        }

        console.log(email.LocalDateStr);
        console.log(email.Subject);

        i = i+1;
    }

    // Set the Deleted flag for each message:
    success = imap.SetFlags(messageSet,"Deleted",1);
    if (success == false) {
        console.log(imap.LastErrorText);
        return;
    }

    // Expunge and close the mailbox.
    success = imap.ExpungeAndClose();
    if (success == false) {
        console.log(imap.LastErrorText);
        return;
    }

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

}

chilkatExample();