(Node.js) Enable Chilkat Classes in JavaScript

See more JavaScript Examples

Note: This example requires Chilkat v11.4.0 or greater.

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

var os = require('os');
if (os.platform() == 'win32') {  
  var chilkat = require('@chilkat/ck-node23-win64'); 
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node23-linux-arm');
    } else if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node23-linux-arm64');
    } else {
        var chilkat = require('@chilkat/ck-node23-linux-x64');
    }
} else if (os.platform() == 'darwin') {
  var chilkat = require('@chilkat/ck-node23-mac-universal');
}

function chilkatExample() {

    var success = false;

    // Chilkat classes within JavaScript are disabled by default.
    // An attempt to instantiate a disabled Chilkat class results in a JavaScript exception.

    // For example, try the following JavaScript without first enabling the Chilkat class:

    // sb = new CkStringBuilder();
    // sb.Append('Hello World');
    // success = sb.WriteFile('c:/aaworkarea/helloWorld.txt','utf-8',true);

    var sbJavaScript = new chilkat.StringBuilder();
    sbJavaScript.Append("sb = new CkStringBuilder(); sb.Append('Hello World'); success = sb.WriteFile('c:/aaworkarea/helloWorld.txt','utf-8',true);");

    var js = new chilkat.Js();

    var result = new chilkat.JsonObject();
    result.EmitCompact = false;

    // Run the script.  This should result in an error because we haven't enabled the Chilkat CkStringBuilder class.
    success = js.Eval(sbJavaScript,result);
    if (success == false) {
        // Examine the result for an exception.
        console.log(result.Emit());

        // The result contains this:
        // {
        //   "exception": {
        //     "message": "Cannot create the chilkat object because the chilkat class is disabled in JavaScript. Fix by calling SetCkPermission before calling Eval or CallFunction",
        //     "stack": [
        //       {
        //         "func": "CkStringBuilder"
        //       },
        //       {
        //         "func": "<eval>",
        //         "file": "<input>",
        //         "line": 1,
        //         "col": 9
        //       }
        //     ]
        //   }
        // }

    }

    // Enable the Chilkat CkStringBuilder JavaScript class for readWrite
    js.SetCkPermission("CkStringBuilder","readWrite");
    // The script should work now...
    success = js.Eval(sbJavaScript,result);
    console.log("success = " + success);

    // If the CkStringBuilder class is enabled for readOnly or sandbox, then it will fail.
    //   - Chilkat methods that could directly or indirectly write to the filesystem require writeOnly or readWrite access.
    //   - Chilkat methods that read the local filesystem require readOnly or readWrite access.
    //   - Chilkat methods that don't interact with the local filesystem work in any mode including sandbox.
    js.SetCkPermission("CkStringBuilder","readOnly");
    success = js.Eval(sbJavaScript,result);
    if (success == false) {
        // Examine the result for an exception.
        console.log(result.Emit());

        // {
        //   "exception": {
        //     "message": "failed because this Chilkat method requires the writeOnly or readWrite permission",
        //     "stack": [
        //       {
        //         "func": "WriteFile"
        //       },
        //       {
        //         "func": "<eval>",
        //         "file": "<input>",
        //         "line": 1,
        //         "col": 67
        //       }
        //     ]
        //   }
        // }
    }


}

chilkatExample();