编程 API — JZ 和 JUSTZIX

什么是页面内辅助 API

JustZix 规则中的每段 JavaScript——以及每个操作按钮背后的代码——都运行在一个已经为你准备好两个全局对象的上下文中：window.JZ 和 window.JUSTZIX。无需导入，无需加载；从脚本的第一行起它们就可用。

这是一个刻意保持精简的 API。它不提供数百个方法，而是给你两个稳固的支点：一个用于驱动操作按钮，一个用于日志记录。其余的一切都用页面普通的 JavaScript 完成。

JZ — 驱动操作按钮

JZ 对象将你的代码与扩展的操作按钮连接起来。关键方法有：

• JZ.click('LBL') — 以编程方式点击标签为“LBL”的操作按钮。
• JZ.action('LBL') — 返回按钮的 DOM 元素，便于你设置样式或检查属性。
• JZ.actions() — 所有可见操作按钮的数组。
• JZ.labels() — 原始标签的数组，保留大小写。

标签查找不区分大小写——JZ.click('btn') 和 JZ.click('BTN') 命中同一个按钮。

JUSTZIX — 写入 Output Console 的日志

JUSTZIX 对象是一个直接写入扩展 Output Console 窗口的日志器。它提供 JUSTZIX.log()、.warn()、.error()、.info() 和 .debug()——每个都会以相应级别追加一条记录。别名 __JUSTZIX__ 和 JZ.log 也随手可用。

这样你无需打开 DevTools 就能追踪规则正在做什么。消息落到一个安静的地方，与浏览器控制台的噪音分隔开。

为何稳定的 API 胜过手写 DOM 胶水代码

你也可以通过选择器查找按钮并派发自己的事件，但这种代码会在扩展布局变动时立刻失效。JZ 和 JUSTZIX 给你一份稳定的契约：无论内部如何变化，相同的方法名都能工作。

将它与 mutation observer 搭配，你就拥有了一条真正的工作流——规则等待某个元素出现，点击一系列操作并报告结果：

// 操作“AUTO”——串联其他三个操作
JZ.click('LOAD');
setTimeout(() => JZ.click('PROC'), 500);
setTimeout(() => { JZ.click('SAVE'); JUSTZIX.info('完成'); }, 1500);