JavaScript

Get a To Recipient's Name Only

Demonstrates the Chilkat Email.GetToName method, which returns only the friendly-name part (not the address) of the Nth To recipient. The index is zero-based. This example adds two To recipients and prints each one's display name.

Background: The display name is the human-friendly label attached to an address, like Joe Smith for joe@example.com. It is optional and purely cosmetic but useful for presentation. GetToName returns just that name; if a recipient was added without one, the result is empty, in which case fall back to GetToAddr.

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 GetToName method, which returns only the friendly-name part (not the
//  address) of the Nth To recipient.  The index is zero-based.

var email = new CkEmail();
email.Subject = "GetToName example";

email.AddTo("Joe Smith","joe@example.com");
email.AddTo("Jane Doe","jane@example.com");

var n = email.NumTo;
var i;
for (i = 0; i <= n - 1; i++) {
    console.log("To " + i + " name: " + email.GetToName(i));
}