Table of Contents | Previous | Next | Index


SendMail

Sends an email message.

Server-side object

Implemented in

NES 3.0

The To and From attributes are required. All other properties are optional.

Created by

The SendMail constructor:

new SendMail(); 

Parameters

None.

Description

Whatever properties you specify for the SendMail object are sent in the header of the mail message.

The SendMail object allows you to send either simple text-only mail messages or complex MIME-compliant mail or add attachments to your message. To send a MIME message, set the Content-Type property to the MIME type of the message.

You can use the prototype property of the SendMail object to add a property to all SendMail instances. If you do so, that addition applies to all SendMail objects running in all applications on your server, not just in the single application that made the change. This allows you to expand the capabilities of this object for your entire server.

Property Summary

Property Description
Bcc

Comma-delimited list of recipients of the message whose names should not be visible in the message.

Body

Text of the message.

Cc

Comma-delimited list of additional recipients of the message.

constructor

Specifies the function that creates an object's prototype.

Errorsto

Address to which to send errors concerning the message. Defaults to the sender's address.

From

User name of the person sending the message.

Organization

Organization information.

prototype

Allows the addition of properties to a SendMail object.

Replyto

User name to which replies to the message should be sent. Defaults to the sender's address.

Smtpserver

Mail (SMTP) server name. Defaults to the value specified through the setting in the Administration server.

Subject

Subject of the message.

To

Comma-delimited list of primary recipients of the message.

Method Summary

Method Description
errorCode

Returns an integer error code associated with sending this message.

errorMessage

Returns a string associated with sending this message.

send

Sends the mail message represented by this object.

In addition, this object inherits the watch and unwatch methods from Object.

Examples

Example 1: The following script sends mail to vpg and gwp, copying jaym, with the specified subject and body for the message:

<server>
SMName = new SendMail();
SMName.To = "vpg@co1.com, gwp@co2.com"
SMName.From = "me@myco.com"
SMName.Cc = "jaym@hisco.com"
SMName.Subject = "The State of the Universe"
SMName.Body = "The universe, contrary to what you may have heard, is in none too shabby shape. Not to worry! --me"
SMName.send()
</server>
Example 2: The following example sends an image in a GIF file:

sm = new SendMail(); 
sm.To = "satish";
sm.From = "satish@netscape.com";
sm.Smtpserver = "fen.mcom.com";
sm["Errors-to"] = "satish";
sm["Content-type"] = "image/gif";
sm["Content-Transfer-Encoding"] = "base64";
file = new File("/u/satish/LiveWire/mail/banner.gif");
openFlag = file.open("r");
if ( openFlag ) {
   len = file.getLength();
   str = file.read(len);
   sm.Body = str;
}
sm.send();
Example 3: The following example sends a multipart message:

sm = new SendMail(); 
sm.To = "chandra@cs.uiowa.edu, satish@netscape.com";
sm.From = "satish@netscape.com";
sm.Smtpserver = "fen.mcom.com";
sm.Organization = "Netscape Comm Corp";
sm["Content-type"] = "multipart/mixed; boundary=\"------------8B3F7BA67B67C1DDE6C25D04\"";
file = new File("/u/satish/LiveWire/mail/mime");
openFlag = file.open("r");
if ( openFlag ) {
   len = file.getLength();
   str = file.read(len);
   sm.Body = str;
}
sm.send();
The file mime has HTML text and an Microsoft Word document separated by the specified boundary. The resulting message appears as HTML text followed by the Microsoft Word attachment.


Bcc

Comma-delimited list of recipients of the message whose names should not be visible in the message.

Property of

SendMail

Implemented in

NES 3.0


Body

Text of the message.

Property of

SendMail

Implemented in

NES 3.0


Cc

Comma-delimited list of additional recipients of the message.

Property of

SendMail

Implemented in

NES 3.0


constructor

Specifies the function that creates an object's prototype. Note that the value of this property is a reference to the function itself, not a string containing the function's name.

Property of

SendMail

Implemented in

NES 2.0

Description

See Object.constructor.


errorCode

Returns an integer error code associated with sending this message.

Method of

SendMail

Implemented in

NES 3.0

Syntax

public errorCode();

Returns

The possible return values and their meanings are as follows:

0

Successful send.

1

SMTP server not specified.

2

Specified mail server is down or doesn't exist.

3

At least one receiver's address must be specified to send the message.

4

Sender's address must be specified to send the message.

5

Mail connection problem; data not sent.


errorMessage

Returns a string associated with sending this message.

Method of

SendMail

Implemented in

NES 3.0

Syntax

public errorMessage();

Returns

An error string.


Errorsto

Address to which to send errors concerning the message. Defaults to the sender's address.

Property of

SendMail

Implemented in

NES 3.0


From

User name of the person sending the message.

Property of

SendMail

Implemented in

NES 3.0


Organization

Organization information.

Property of

SendMail

Implemented in

NES 3.0


prototype

Represents the prototype for this class. You can use the prototype to add properties or methods to all instances of a class. For information on prototypes, see Function.prototype.

Property of

SendMail

Implemented in

NES 2.0


Replyto

User name to which replies to the message should be sent. Defaults to the sender's address.

Property of

SendMail

Implemented in

NES 3.0


send

Sends the mail message represented by this object.

Method of

SendMail

Implemented in

NES 3.0

Syntax

public send ();

Returns

This method returns a Boolean value to indicate whether or not the mail was successfully sent. If the mail was not successfully sent, you can use the errorMessage and errorCode methods to determine the nature of the error.

This method returns a string indicating the nature of the error that occurred sending the message.


Smtpserver

Mail (SMTP) server name. Defaults to the value specified through the setting in the Administration server.

Property of

SendMail

Implemented in

NES 3.0


Subject

Subject of the message.

Property of

SendMail

Implemented in

NES 3.0


To

Comma-delimited list of primary recipients of the message.

Property of

SendMail

Implemented in

NES 3.0


Table of Contents | Previous | Next | Index

Last Updated: 11/13/98 10:23:48

Copyright © 1998 Netscape Communications Corporation

Any sample code included above is provided for your use on an "AS IS" basis, under the Netscape License Agreement - Terms of Use