Run JXA code and get the result
JXA is JavaScript for Automation on macOS. Requires macOS 10.10 or later.
$ npm install run-jxa
Use a function:
import {runJxa} from 'run-jxa';
const result = await runJxa((unicorn, horse) => {
// This is run in the JXA engine
return `I love ${unicorn} & ${horse}`;
}, ['🦄', '🐴']);
console.log(result);
//=> 'I love 🦄 & 🐴'Or a string:
import {runJxa} from 'run-jxa';
const result = await runJxa(`
const [unicorn, horse] = args;
return \`I love \${unicorn} & \${horse}\`;
`, ['🦄', '🐴']);
console.log(result);
//=> 'I love 🦄 & 🐴'Returns a Promise for the value returned from input.
Returns the value returned from input.
Type: Function | string
If a function, it's stringified and passed to JXA. It should be pure, meaning it doesn't access anything outside its body.
If a string, you can access the specified arguments with args array. Use the arguments parameter rather than template interpolation so you don't have to do escaping.
You can console.log inside input. It will be forwarded to stdout. Useful for debugging.
Note: The JXA context is completely synchronous, so asynchronous functions like setTimeout are not available.
Type: unknown[]
Arguments to pass to the JXA context.
Items should be serializable (JSON.stringify'able).
- is-jxa - Check if your code is running in a JXA environment
