https://github.com/hhas/nodeautomation
macOS Apple event (“AppleScript”) bridge for Node.js
https://github.com/hhas/nodeautomation
applescript automation javascript
Last synced: 3 months ago
JSON representation
macOS Apple event (“AppleScript”) bridge for Node.js
- Host: GitHub
- URL: https://github.com/hhas/nodeautomation
- Owner: hhas
- License: other
- Created: 2020-06-30T19:13:07.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-02-25T17:26:02.000Z (over 2 years ago)
- Last Synced: 2025-02-23T04:04:27.809Z (4 months ago)
- Topics: applescript, automation, javascript
- Language: JavaScript
- Homepage:
- Size: 914 KB
- Stars: 30
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 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.
See also: http://appscript.sourceforge.net/status.html
______________________________________________________________________________
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.