JavaScript

Fetch an IMAP Message's MIME into a BinData

Demonstrates the Chilkat Imap.FetchSingleBd method, which downloads one message's MIME bytes into a BinData object. If the second argument (bUid) is true, the first argument is a UID; otherwise it is a sequence number. This example downloads message 1's MIME into a BinData and prints the byte count.

Background: This is the binary counterpart to FetchSingleAsMime (which returns a string). A BinData holds raw bytes, so it preserves the message exactly — the right choice when you plan to write the MIME straight to a file, hash it, or hand it to an API expecting a byte buffer, with no charset conversion that could alter binary content.

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 Imap.FetchSingleBd method, which downloads one message's MIME bytes into a
//  BinData object.  If the 2nd argument (bUid) is true, the 1st argument is a UID; otherwise
//  it is a sequence number.

var imap = new CkImap();

imap.Ssl = true;
imap.Port = 993;

success = imap.Connect("imap.example.com");
if (success == false) {
    console.log(imap.LastErrorText);
    return;
}

success = imap.Login("user@example.com","myPassword");
if (success == false) {
    console.log(imap.LastErrorText);
    return;
}

success = imap.SelectMailbox("Inbox");
if (success == false) {
    console.log(imap.LastErrorText);
    return;
}

//  Download message sequence number 1's MIME bytes into a BinData.  bUid = false.
var bdMime = new CkBinData();
success = imap.FetchSingleBd(1,false,bdMime);
if (success == false) {
    console.log(imap.LastErrorText);
    return;
}

console.log("MIME size (bytes) = " + bdMime.NumBytes);

success = imap.Disconnect();
if (success == false) {
    console.log(imap.LastErrorText);
    return;
}