JavaScript

Count the Messages in a multipart/digest Email

Demonstrates the read-only Chilkat Email.NumDigests property, which is the number of message/rfc822 parts contained within a multipart/digest enclosure. If no such enclosure exists, the value is 0. Digest indexes are zero-based; use GetDigestEmail to retrieve an individual bundled message as its own Email object. This example loads a digest email and lists each message's subject.

Background: A multipart/digest is a way to package many separate emails inside one carrier message — historically used by mailing lists to send a single daily "digest" containing all of that day's posts. Each bundled item is a complete message/rfc822 email with its own headers and body. This differs from NumAttachedMessages, which counts nested messages attached to an ordinary email rather than the members of a digest enclosure.

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.

JavaScript

var success = false;

//  Demonstrates the read-only Email.NumDigests property, which is the number of
//  message/rfc822 parts contained within a multipart/digest enclosure.  If there is no
//  multipart/digest enclosure, the value is 0.  Digest indexes are zero-based.

var email = new CkEmail();

//  Load a multipart/digest email (a single email that bundles many messages).
success = email.LoadEml("qa_data/eml/digest.eml");
if (success == false) {
    console.log(email.LastErrorText);
    return true;
}

var n = email.NumDigests;
console.log("NumDigests = " + n);

//  Retrieve each bundled message as its own Email object.
var digestEmail = new CkEmail();
var i;
for (i = 0; i <= n - 1; i++) {
    success = email.GetDigestEmail(i,digestEmail);
    console.log("Digest " + i + " subject: " + digestEmail.Subject);
}

//  Note: Paths such as "qa_data/..." are relative local filesystem paths,
//  relative to the current working directory of the running application.