JavaScript

Clear an Email Object

Demonstrates the Chilkat Email.Clear method, which removes the current message content — recipients, headers, body representations, attachments, related items, and embedded messages — leaving an empty email object. This example builds a message with a recipient and attachment, clears it, and prints the counts before and after.

Background: Reusing a single Email object across many operations is efficient, but leftover state from a previous message could leak into the next. Clear resets the object completely, giving you a clean slate — the safe way to start a fresh message without allocating a new object.

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

//  Demonstrates the Clear method, which removes the current message content, including
//  recipients, headers, body representations, attachments, related items, and embedded
//  messages -- leaving an empty email object.

var email = new CkEmail();
email.Subject = "A message";
email.Body = "Some body text.";
email.AddTo("Bob","bob@example.com");
email.AddStringAttachment("notes.txt","Some notes.");

console.log("NumTo before clear = " + email.NumTo);
console.log("NumAttachments before clear = " + email.NumAttachments);

//  Remove all content, resetting the email object.
email.Clear();

console.log("NumTo after clear = " + email.NumTo);
console.log("NumAttachments after clear = " + email.NumAttachments);