JavaScript

Add Multiple To Recipients at Once

Demonstrates the Chilkat Email.AddMultipleTo method, which parses a comma-separated list of mailbox addresses and appends them all to the direct-recipient (To) list. Each entry may include a display name (e.g. Joe <joe@example.com>). This example adds three To recipients in a single call.

Background: The To header holds a message's primary recipients, and email allows any number of them as a comma-separated list. AddMultipleTo parses that standard syntax — accepting both bare addresses and named forms — so when your recipients arrive as one string (from a form field, database column, or config value) you can populate the whole To list in one step instead of calling AddTo per recipient.

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 AddMultipleTo method, which parses a comma-separated list of
//  addresses and appends them all to the direct-recipient (To) list.

var email = new CkEmail();
email.Subject = "Multiple To example";
email.From = "alice@example.com";

//  Add several To recipients at once.  Each entry may include a display name.
email.AddMultipleTo("Joe <joe@example.com>, jane@example.com, Bob <bob@example.com>");

console.log("NumTo = " + email.NumTo);