A Node.js utility for running AppleScript code and returning the result. It provides an async `runAppleScript` (Promise of a string) and a synchronous `runAppleScriptSync` (string result), with options like `humanReadableOutput` to control output formatting and `signal` to cancel execution.
Project status
- The GitHub source appears to be actively maintained in the sense that there are recent
updates(v7.1.0 on 2025-09-09) and it continues to add API capabilities, including newsignalcancellation support for the asyncrunAppleScriptAPI. - Apparent update cadence is low but not extinct, with the most recent change in 2025 and the previous major change in 2023 (about a 2-year gap between major updates), suggesting a slower maintenance pace rather than rapid iteration.
AI summary generated
Recent updates
v7.1.0
v7.1.0 adds cancellation support to the async `runAppleScript` API by introducing a new `signal` option (AbortSignal). The implementation forwards the signal to Node's `execFile` so the underlying `osascript` process can be aborted.
Featuresv7.0.0
v7.0.0 primarily updates the package to require Node.js 18. The diff also replaces the internal execution mechanism from execa to Node's child_process APIs and adjusts output handling and process options.
Breakingv6.1.0
v6.1.0 adds a new option, `humanReadableOutput`, to control how `osascript` formats results. The async and sync APIs were extended to accept an optional options object, and tests and documentation were updated accordingly.
Featuresv6.0.0
v6.0.0 primarily changes the public async API by renaming the exported function. The code diff also includes CI workflow updates and dependency version bumps, none of which are covered by the release notes.
Breakingv5.0.0
v5.0.0 converts the package to pure ESM, drops the default export, and introduces two named exports: runAppleScriptAsync and runAppleScriptSync. It also raises the minimum Node.js version to 12 and updates the project tooling and dependencies.
Breakingv4.0.0
v4.0.0 introduces TypeScript type definitions for the package and makes a major runtime requirement change. The release is labeled breaking because it requires an updated Node.js version to run the library.
BreakingFeatures