Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
src
test
CHANGELOG.md
LICENSE
README.md
package.json
tsconfig.json

README.md

@jxa/run

Run JXA code and get result.

Install

Install with npm:

npm install @jxa/run

Requirement:

  • macOS 10.10 or later.

Usage

export declare function run<R>(jxaCodeFunction: (...args: any[]) => void, ...args: any[]): Promise<R>

Illustration of usage

const resultPromise = run(JSXFn, argumentsOfJSXFn);
  • JSXFn: This function is run as JXA.
    • 📝 This JSXFn is serialized(toString) and pass to JXA environment.
    • :waring: Warning: function cannot close over variables in a parent's scope.
    • Pass data as arguments explicitly instead.
  • argumentsOfJSXFn: An arguments of JSXFn

OK:

// OK
(async () => {
    // `name` is "nodejs"
    const result = await run(name => {
        return "Hello there, " + name + "!"
    }, "nodejs");
    assert.strictEqual(result, "Hello there, nodejs!");
})();

NG:

// NG
(async () => {
    const name = "nodejs"
    const result = await run(name => {
        return "Hello there, " + name + "!"; // can not access to `name` from JXA enviroment
    });
    assert.strictEqual(result, "Hello there, nodejs!");
})();

Example

(async () => {
    const result = await run(
        // run this function as JXA code
        () => {
            return Application("System Events")
                .currentUser()
                .name()
        }
    );
    assert.strictEqual(result, process.env.USER);
})();

Changelog

See Releases page.

Running tests

yarn test

Contributing

Pull requests and stars are always welcome.

For bugs and feature requests, please create an issue.

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

Author

Related

License

MIT © azu