(Node.js) SharePoint -- Download Newer Files

See more SharePoint Examples

Demonstrates how to download all files from a SharePoint folder that are newer than the local files.

Install Chilkat for Node.js and Electron using npm at Chilkat npm packages for Node.js Chilkat npm packages for Electron on Windows, Linux, MacOSX, and ARM

var os = require('os');
if (os.platform() == 'win32') {  
    if (os.arch() == 'ia32') {
        var chilkat = require('@chilkat/ck-node21-win-ia32');
    } else {
        var chilkat = require('@chilkat/ck-node21-win64'); 
    }
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node21-arm');
    } else if (os.arch() == 'x86') {
        var chilkat = require('@chilkat/ck-node21-linux32');
    } else {
        var chilkat = require('@chilkat/ck-node21-linux64');
    }
} else if (os.platform() == 'darwin') {
    if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node21-mac-m1');
    } else {
        var chilkat = require('@chilkat/ck-node21-macosx');
    }
}

function chilkatExample() {

    // This requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    // -------------------------------------------------------------------------
    // The following comments apply to SharePoint Windows classic authentication.
    // -------------------------------------------------------------------------
    // For example, imagine our SharePoint endpoint is https://xyzoffice.mycompany.com/
    // The SHAREPOINT_NTLM_DOMAIN would be "mycompany.com"
    // The SHAREPOINT_HTTPS_DOMAIN would be "xyzoffice.mycompany.com"
    // Also, the SHAREPOINT_USERNAME would be just the name, not a full email address.
    // for example, "chilkat" instead of "chilkat@mycompany.com"

    var http = new chilkat.Http();

    // If SharePoint Windows classic authentication is used, then set the 
    // Login, Password, LoginDomain, and NtlmAuth properties.
    http.Login = "SHAREPOINT_USERNAME";
    http.Password = "SHAREPOINT_PASSWORD";
    http.LoginDomain = "SHAREPOINT_NTLM_DOMAIN";
    http.NtlmAuth = true;

    // -------------------------------------------------------------------------
    // The more common case is to use SharePoint Online authentication (via the SPOIDCRL cookie).
    // If so, do not set Login, Password, LoginDomain, and NtlmAuth, and instead
    // establish the cookie as shown at SharePoint Online Authentication
    // -------------------------------------------------------------------------

    // First we'll download a list of all the files in the /Documents folder.
    // This provides the names and last-modified date/times of the files located
    // on the SharePoint server.
    http.Accept = "application/json;odata=verbose";
    http.AcceptCharset = "utf-8";

    var sbJson = new chilkat.StringBuilder();
    var success = http.QuickGetSb("https://SHAREPOINT_HTTPS_DOMAIN/_api/web/GetFolderByServerRelativeUrl('/Documents')/Files",sbJson);
    if (success !== true) {
        console.log(http.LastErrorText);
        return;
    }

    // Before proceeding, make sure the local directory where we'll be downloading files exists.
    var fac = new chilkat.FileAccess();
    fac.DirEnsureExists("qa_output/sharepoint/Documents");

    // OK.. load the JSON and iterate over each file
    var json = new chilkat.JsonObject();
    json.LoadSb(sbJson);

    var numFiles = json.SizeOfArray("d.results");
    console.log("Number of Files in the SharePoint /Documents folder = " + numFiles);

    var lastModRemote = new chilkat.CkDateTime();
    // lastModLocal: CkDateTime
    var lastModLocal;

    var localPath = new chilkat.StringBuilder();
    var fileUrl = new chilkat.StringBuilder();

    var i = 0;
    while (i < numFiles) {
        json.I = i;

        var filename = json.StringOf("d.results[i].Name");
        var sLastModified = json.StringOf("d.results[i].TimeLastModified");

        console.log((i+1) + ": " + filename + " (" + sLastModified + ")");

        lastModRemote.SetFromTimestamp(sLastModified);

        var bDownload = false;
        // Check to see if the local file exists.  If not, then download.
        localPath.SetString("qa_output/sharepoint/Documents/");
        localPath.Append(filename);
        if (fac.FileExists(localPath.GetAsString()) !== true) {
            console.log("This file does not exist locally.");
            bDownload = true;
        }
        else {
            // Get the local file's date time and compare with the remote file date/time.
            lastModLocal = fac.GetLastModified(localPath.GetAsString());
            if (fac.LastMethodSuccess == true) {
                // Get the difference in seconds between the local and remote last-modified times.
                // if the return value is negative, then the caller's time is 
                // older than the argument.  (in this case, a negative return value means
                // the local file is older than the remote file.

                // Note: The DiffSeconds method was found to be missing in the Chilkat .NET build
                // (and possibly in other builds). It will be present in the v9.5.0.67 release and later.
                var numSeconds = lastModLocal.DiffSeconds(lastModRemote);
                if (numSeconds < 0) {
                    console.log("The local file is older than the remote file.");
                    bDownload = true;
                }

            }
            else {
                console.log("Unable to get the local file's last-modified date/time.");
                console.log(fac.LastErrorText);
            }

        }

        if (bDownload == true) {
            fileUrl.SetString("https://SHAREPOINT_HTTPS_DOMAIN/_api/web/GetFolderByServerRelativeUrl('/Documents')/Files('");
            fileUrl.Append(filename);
            fileUrl.Append("')/$value");

            console.log("Downloading " + filename);

            success = http.Download(fileUrl.GetAsString(),localPath.GetAsString());
            if (success !== true) {
                console.log(http.LastErrorText);
                return;
            }

            // Set the local file's last-modified date/time to that of the server's.
            fac.SetLastModified(localPath.GetAsString(),lastModRemote);

        }

        i = i+1;
    }

    console.log("All finished.");

}

chilkatExample();