(JavaScript) Determine the Number of Unseen Email Messages

Demonstrates how to determine how many unseen messages exist in an email account on an IMAP server.

Note

This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.

var success = false;

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

var imap = new CkImap();

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

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

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

// After selecting the mailbox. the total number of emails
// is immediately available:
var totalNum = imap.NumMessages;
console.log("Num messages = " + totalNum);

// To determine the number of unseen messages, a call
// to Search is required, which returns the set of UIDs
// of all unseen messages.

// We can choose to fetch UIDs or sequence numbers.
var fetchUids = true;
var messageSet = new CkMessageSet();
success = imap.QueryMbx("UNSEEN",fetchUids,messageSet);
if (success == false) {
    console.log(imap.LastErrorText);
    return;
}

var numUnseen = messageSet.Count;
console.log(numUnseen);

console.log("UIDs ----");

// Display the UIDs
var i = 0;
while (i < messageSet.Count) {
    console.log(messageSet.GetId(i));
    i = i+1;
}

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