(JavaScript) Load .eml and Examine the Structure, Attachments, and Related Items

Demonstrates how to load examine the MIME structure of a .eml, and also examine the attachment and related item filenames, attached messages, and multipart/report and DSN information.

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

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 emlPath = "C:/AAWorkarea/beatrix/roesner.eml";

var mime = new CkMime();

success = mime.LoadMimeFile(emlPath);
if (success == false) {
    console.log(mime.LastErrorText);
    return;
}

console.log("---- MIME structure ----");
console.log(mime.GetStructure("text"));
console.log("------------------------");

var email = new CkEmail();
success = email.LoadEml(emlPath);

// Was this a signed and/or encrypted email?
// If so, then loading the .eml automatically unwraps
// (i.e. verifies signatures and decrypts) and the resultant
// email is what existed prior to signing/encrypting.
console.log("Email was Signed: " + email.ReceivedSigned);
console.log("Email was Encrypted: " + email.ReceivedEncrypted);
if (email.ReceivedSigned == true) {
    console.log("Signature(s) valid = " + email.SignaturesValid);
}

if (email.ReceivedEncrypted == true) {
    console.log("Decrypted successfully = " + email.Decrypted);
}

var i = 0;
var numAttach = email.NumAttachments;
console.log("Number of attachments = " + numAttach);

while (i < numAttach) {
    console.log("---- Attachment " + i);

    // Examine the filename (if any)
    console.log("filename: " + email.GetAttachmentFilename(i));
    // Examine the content-ID (if any)
    console.log("Content-ID: " + email.GetAttachmentContentID(i));
    // Examine the content-type
    console.log("Content-Type: " + email.GetAttachmentContentType(i));
    // Examine the content-disposition
    console.log("Content-Disposition" + email.GetAttachmentHeader(i,"content-disposition"));
    // Examine the attachment size:
    console.log("Size (in bytes) of the attachment: " + email.GetAttachmentSize(i));

    i = i+1;
}

console.log("--");

// Now for the related items.

// Note: A MIME sub-part can potentially be both a related item AND an attachment.
// The typical case is when the item is contained under the multipart/related enclosure and 
// the item also has a "Content-Disposition" header indicating "attachment".
// The location within multipart/related makes it a "related item", yet the Content-Disposition can also make it semantically an attachment.
// Related items and attachments are not necessarily mutually exclusive.

var numRelated = email.NumRelatedItems;
console.log("Number of related items = " + numRelated);
i = 0;
while (i < numRelated) {
    console.log("---- Related Item " + i);

    // Examine the filename (if any)
    console.log("filename: " + email.GetRelatedFilename(i));
    // Examine the content-ID (if any)
    console.log("Content-ID: " + email.GetRelatedContentID(i));
    // Examine the content-type
    console.log("Content-Type: " + email.GetRelatedContentType(i));
    // Examine the content-location (if any)
    console.log("Content-Location" + email.GetRelatedContentLocation(i));

    i = i+1;
}

// The email could also have attached messages.
// An attached message is another email that was attached to this email.
var em = new CkEmail();
var numAttachedMessages = email.NumAttachedMessages;
console.log("Number of attached messages = " + numAttachedMessages);
i = 0;
while (i < numAttachedMessages) {
    console.log("---- Attached message " + i);

    // Examine the attached email
    email.GetAttachedEmail(i,em);
    console.log("from: " + em.From);
    console.log("subject: " + em.Subject);
    i = i+1;
}

// An email could also be a multipart/report email. 
// This is a DSN (Delivery Status Notification)
// The NumReports property indicates how many "reports" exist.
var numReports = email.NumReports;
console.log("Number of reports = " + numReports);
i = 0;
while (i < numReports) {
    console.log("---- Report " + i);
    // Get the raw report data...
    console.log(email.GetReport(i));
    i = i+1;
}

// If the email is a multipart/report, then the information
// from the message/delivery-status part of the email can be retrieved:
if (email.IsMultipartReport() == true) {

    console.log("--- Delivery Status Information:");
    console.log("Status: " + email.GetDeliveryStatusInfo("Status"));
    console.log("Action: " + email.GetDeliveryStatusInfo("Action"));
    console.log("Reporting-MTA: " + email.GetDeliveryStatusInfo("Reporting-MTA"));

    var jsonDsnInfo = new CkJsonObject();
    email.GetDsnInfo(jsonDsnInfo);
    jsonDsnInfo.EmitCompact = false;
    console.log(jsonDsnInfo.Emit());
}