Nodeautomation NPM

README

NodeAutomation is a Node.js module that allows 'AppleScriptable' applications to be controlled directly from JavaScript.

For example, to get the value of the first paragraph of the document named 'README' in TextEdit:

app('TextEdit').documents.named('README').paragraphs[0].get()

This is equivalent to the AppleScript statement:

tell application "TextEdit" to get paragraph 1 of document "README"

Or to create a new "Hello World!" document in TextEdit:

app('TextEdit').make({new: k.document, 
                      withProperties: {text: "Hello World!"}})

Dependencies:

objc -- https://github.com/hhas/objc (development fork)
libxmljs2
ffi-napi
ref-napi

Documentation:

Documentation is preliminary, being a quick and dirty translation of the original appscript manual. Documentation is included in the nodeautomation package and online:

https://hhas.github.io/nodeautomation/

ASDictionary and ASTranslate tools:

https://sourceforge.net/projects/appscript/files/

Caution: This is an alpha release. There will be bugs and rough edges.

E&OE. No warranty given. Use at own risk. Etc.

Test:

$ node
> require('nodeautomation/repl')
> const finder = app('Finder')
> finder.home()
app('Finder').startupDisk.folders.named('Users').folders.named('jsmith')

Known issues:

Relies on several now-deprecated CoreServices/Cocoa functions/methods for which macOS does not provide replacements.