Node-Applescript 技术文档

1. 安装指南

首先，确保您的系统满足以下要求：

• Mac（或 Hackintosh）运行 macOS（已通过 High Sierra 测试）
• Node.js（版本 0.2.0 或更高）

接下来，使用以下命令通过 npm 安装 node-applescript 模块：

$ npm install applescript

2. 项目使用说明

node-applescript 模块提供了 execString 和 execFile 函数，用于轻松执行 AppleScript 命令并将输出缓冲到回调函数中。

以下是一个基本的 AppleScript 命令示例。它返回当前在 iTunes 中选定的每个轨道的歌曲名称，作为字符串数组。

const applescript = require('applescript');

const script = 'tell application "iTunes" to get name of selection';

applescript.execString(script, (err, rtn) => {
  if (err) {
    // 发生错误！
  }
  if (Array.isArray(rtn)) {
    for (const songName of rtn) {
      console.log(songName);
    }
  }
});

3. 项目API使用文档

execString

执行一个 AppleScript 命令字符串。

参数：

• script: 要执行的 AppleScript 命令字符串。
• callback: 当命令执行完成时的回调函数，它接受两个参数：err（错误对象）和 rtn（返回值）。

示例：

const applescript = require('applescript');

const script = 'tell application "iTunes" to get name of selection';

applescript.execString(script, (err, rtn) => {
  // 处理返回值或错误
});

execFile

与 execString 类似，但接受一个 AppleScript 文件的路径，并可选地传递一个字符串数组作为参数。

参数：

• filePath: AppleScript 文件的路径（.applescript）。
• args: 可选的字符串数组，作为参数传递给 AppleScript 文件。
• callback: 当文件执行完成时的回调函数，它接受两个参数：err（错误对象）和 rtn（返回值）。

示例：

const applescript = require('applescript');

const filePath = '/path/to/your/script.applescript';

applescript.execFile(filePath, ['arg1', 'arg2'], (err, rtn) => {
  // 处理返回值或错误
});

4. 项目安装方式

请参考上述“安装指南”部分，使用 npm 进行安装。

$ npm install applescript

以上就是 node-applescript 项目的技术文档，希望对您有所帮助。如果您在使用过程中遇到任何问题，请参考官方文档或向社区寻求帮助。