如何获取应用支持的函数列表?Hammerspoon macOS自动化场景问询
查询应用可调用接口的具体方法
Hammerspoon调用第三方应用功能的本质是对接macOS原生的AppleScript/JXA自动化体系,你要找的应用可用函数、参数规则都存储在应用自身的AppleScript接口字典里,可以通过以下几种方式查询:
- 用系统自带脚本编辑器查看官方字典
打开启动台「其他」分类里的「脚本编辑器」,点击顶部菜单栏「文件」->「打开字典」,在弹出的应用列表里选中你要查询的目标应用,就能看到完整的接口说明,包含所有可调用的命令、属性、参数取值范围和官方示例。 - 用Hammerspoon控制台直接导出接口列表
调试阶段可以直接在Hammerspoon控制台执行以下命令,直接获取目标应用的全量接口数据:hs.osascript.applescript([[tell application "目标应用名称" to return entire contents of dictionary]])
控制台返回的结构化内容就是完整的可调用函数清单,可以直接保存下来做离线查询。 - 先测试再封装到工作流
建议你先在脚本编辑器里写AppleScript代码验证调用效果,确认逻辑符合预期后再转成Hammerspoon调用代码。比如调用Safari打开新标签的示例:
先在脚本编辑器测试AppleScript代码:
确认可用后转成Hammerspoon代码:tell application "Safari" make new document at end of documents with properties {URL:"https://example.com"} end tellhs.osascript.applescript([[ tell application "Safari" make new document at end of documents with properties {URL:"https://example.com"} end tell ]])
注意:部分应用默认关闭AppleScript调用权限,你需要在「系统设置」->「隐私与安全性」->「自动化」里,找到Hammerspoon条目,开启对应目标应用的权限开关,否则调用会直接报错。
内容的提问来源于stack exchange,提问作者Andreas Rozek
相关产品推荐
相关产品推荐

