node-osascript

Use AppleScript from node.js

Execute AppleScript from node.js and process the results.

Install

$ npm install node-osascript

Overview

Execute AppleScript and use the results of the javascript in node. The result is transformed into a javascript object using PEG.js So AppleScript lists are transformed into an Array, Records into a plain object and Dates to the Date type as well as Numbers, Booleans and Strings.

Examples

Simple

var osascript = require('node-osascript');

osascript.execute('display dialog "What should I do?" buttons {"Go home", "Work", "Nothing"}\nset DlogResult to result\n return result', function(err, result, raw){
  if (err) return console.error(err)
  console.log(result, raw)
});

Injecting Variables

You can inject a javascript object into the script to have acces to these variables.

var osascript = require('node-osascript');

osascript.execute('display dialog message', { message : "Hello from Node.JS" },function(err, result, raw){
  if (err) return console.error(err)
  console.log(result, raw)
});

Timeout

You can force an AppleScript to stop running

  var osascript = require('node-osascript');

  var childProcess = osascript.execute('display dialog "What should I do?" buttons {"Go home", "Work", "Nothing"}\nset DlogResult to result\n return result', function(err, result, raw){
    if (err) return console.error(err)
    console.log(result, raw)
  });

  //after 20 seconds, the AppleScript will be killed
  setTimeout(function(){
    console.log('kill');
    childProcess.stdin.pause();
    childProcess.kill();
  },20000)

API

Methods

execute(script, [variables], callback)

Execute the script, if specified injecting the variables into the AppleScript.

osascript.execute('script', { varName : 'value'}, function(err, result, raw){
  if (err) return console.error(err)
    console.log(result, raw)
});

executeFile(path, [variables], callback)

Execute file in path, if specified injecting the variables into the AppleScript.

osascript.executeFile('path/to/script.scpt', { varName : 'value'}, function(err, result, raw){
  if (err) return console.error(err)
    console.log(result, raw)
});

Tests

To run platform independent tests use:

npm test

If you are on macOS you can run all tests using:

npm testall

License

MIT

node-osascript - Change Log

All notable changes to this project will be documented here.

2.1.0 - 2018-08-07

• Ability to kill a running AppleScript

2.0.0

• Remove grunt
• Upgrade to pegjs@0.10.0
• lint using xo

1.0.4

• Fix for breaking change in node 6 (See #7 Thanks to rosszurowski)
• Update dependencies

1.0.3

• When date cannot be parsed by Javascript, return original string value (See #5)
• Added support for multiline strings and for unquoted strings in osascript output (See #5)

1.0.2

• Unrecognized result is know always treated as a raw string. (Fix #3)

1.0.1

• Fix a bug where empty results where considert an error (Fix #2)

1.0.0

• Stable release
• Fix package.json

0.0.1

• Inital release