Using JavaScript in HomeSite 4.0, Part III: The HTTPProvider Object's Methods, Part II

Using JavaScript in HomeSite 4.0, Part III

The HTTPProvider Object's Methods, Part II

SaveReceivedStreamToFile(fileName, overwriteFlag) String

This method saves the received stream to a file, and overwrites an existing file if overwriteFlag is true. This method returns an error message upon failure. It returns "File already exists" when the given fileName exists and overwriteFlag is false. It returns "Path does not exist" when fileName is not found.

The following script reads an html page from a server and tries to save it to a local disk:

var app = Application;
function Main() {
  var app = Application;
  app.HTTPProvider.URL = "http://www.webreference.com/js/tips/990923.html";
  app.HTTPProvider.Get();
  var errorMsg = app.HTTPProvider.SaveReceivedStreamToFile
   ("d:\\yehuda\\990923.html", false );
  // (The above two lines should be joined as one line.
  // They have been split for formatting purposes.)
  if (errorMsg != "")
    {
     app.MessageBox("Save failed: " + errorMsg, "Save Error", 0);
    }
  app = null;
}

The first run of this script creates the file on the local disk. The second run will fail to overwrite the existing file because the overwriteFlag is false. This is the window that will pop up: