Zig Requires Chilkat v11.4.0+

Enable Chilkat Classes in JavaScript

See more JavaScript Examples

To use Chilkat classes in JavaScript, you must first enable them in the host application, as they are disabled by default. Instantiating a disabled class will cause a JavaScript exception. Chilkat classes can be enabled in four local filesystem access modes: sandbox, readOnly, writeOnly, or readWrite. You can also enable all classes in a chosen mode. Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    var success: bool = 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);

    const sb_java_script = try chilkat.StringBuilder.init();
    defer sb_java_script.deinit();
    sb_java_script.append("sb = new CkStringBuilder(); sb.Append('Hello World'); success = sb.WriteFile('c:/aaworkarea/helloWorld.txt','utf-8',true);") catch {};

    const js = try chilkat.Js.init();
    defer js.deinit();

    const result = try chilkat.JsonObject.init();
    defer result.deinit();
    result.setEmitCompact(false);

    // Run the script.  This should result in an error because we haven't enabled the Chilkat CkStringBuilder class.
    success = if (js.eval(sb_java_script, result)) true else |_| false;
    if (!success) {
        // Examine the result for an exception.
        std.debug.print("{s}\n", .{try result.emit(alloc)});

        // 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") catch {};
    // The script should work now...
    success = if (js.eval(sb_java_script, result)) true else |_| false;
    std.debug.print("success = {}\n", .{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") catch {};
    js.eval(sb_java_script, result) catch {
        // Examine the result for an exception.
        std.debug.print("{s}\n", .{try result.emit(alloc)});

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