JavaScript

Check FTP Connection and Login Status

Demonstrates the connection-status properties ConnectVerified, LoginVerified, ConnectFailReason, and Greeting.

Background: When Connect fails, these properties separate the possible causes: ConnectVerified shows whether the TCP connection was established at all, LoginVerified whether authentication then succeeded, and ConnectFailReason gives a numeric code pinpointing the failure — far more actionable than a generic error for distinguishing, say, an unreachable host from a bad password. The Greeting captures the server's opening banner, sometimes useful for identifying the server or its policies.

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;

var ftp = new CkFtp2();

ftp.Hostname = "ftp.example.com";
ftp.Username = "myFtpLogin";

//  Normally you would not hard-code the password in source.  You should instead obtain it
//  from an interactive prompt, environment variable, or a secrets vault.
ftp.Password = "myPassword";

success = ftp.Connect();
if (success !== true) {
    //  ConnectFailReason gives a numeric code describing why Connect failed.
    console.log("Connect failed, reason code: " + ftp.ConnectFailReason);
    console.log(ftp.LastErrorText);
    return;
}

//  After a successful connect, these flags report what succeeded.
console.log("TCP connection verified: " + ftp.ConnectVerified);
console.log("Login verified: " + ftp.LoginVerified);

//  The Greeting property holds the server's initial greeting banner.
console.log("Server greeting: " + ftp.Greeting);

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