/run-jxa

Run JXA code and get the result

Primary LanguageJavaScriptMIT LicenseMIT

run-jxa

Run JXA code and get the result

JXA is JavaScript for Automation on macOS. Requires macOS 10.10 or later.

Install

$ npm install run-jxa

Usage

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 🦄 & 🐴'

API

runJxa(input, arguments?)

Returns a Promise for the value returned from input.

runJxaSync(input, arguments?)

Returns the value returned from input.

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.

arguments

Type: unknown[]

Arguments to pass to the JXA context.

Items should be serializable (JSON.stringify'able).

Related

  • is-jxa - Check if your code is running in a JXA environment