API 参考
扩展 API 的汇总参考。状态图例:
- ✅ 可用 —— 按预期工作。
- 🟡 部分 —— 可用但有注意事项(见说明)。
- ⬜ 桩 —— 存在但返回默认值 / no-op。
HCJ hcj.*（页面侧）
| API | 状态 | 说明 |
|---|---|---|
hcj.config.get / set / remove / all | ✅ | 持久化 KV，需 STORAGE 权限 |
hcj.fetch | ✅ | 经 OkHttp 跨域，需 FETCH；返回 Promise。支持 {method, headers, body}；responseType: "base64" 时 body 按 base64 返回（encoding 字段标识），用于二进制载荷 |
hcj.notify | ✅ | 系统通知，需 NOTIFY |
hcj.toast | ✅ | 页面内浮层提示——操作反馈用它，hcj.notify 留给真正的系统通知 |
hcj.badge | ✅ | 工具栏角标，需 BADGE |
hcj.addStyle | ✅ | 注入页面 CSS 为 <style id="hcj-css-<id>">，按插件按文档幂等 |
hcj.panel.open / close / send / onMessage | ✅ | 由用户选定的面板宿主承载 |
hcj.on('action') / hcj.emit | ✅ | 入口点击 / 自定义事件 |
hcj.on('navigate') | ✅ | 每次 URL 变化触发（含 SPA pushState），载荷 {url}——在此重新绑定页面钩子 |
hcj.share(title, text, url) | ✅ | 系统分享面板，需 SHARE |
hcj.openExternal(url) | ✅ | 用外部应用打开 http(s) 链接，需 OPEN_EXTERNAL |
hcj.clearData() | ✅ | 清除页面的 Cookie/存储/缓存/历史，需 CLEAR_DATA |
hcj.exitApp() | ✅ | 结束宿主 Activity，需 EXIT_APP |
hcj.id / hcj.manifest / hcj.lang | ✅ |
hcjPanel.*（面板侧）
| API | 状态 | 说明 |
|---|---|---|
hcjPanel.config.* | ✅ | 与页面侧同一个 KV 存储 |
hcjPanel.send / hcjPanel.onMessage / hcjPanel.close | ✅ | 面板 ↔ 页面通道与关闭 |
hcjPanel.toast | ✅ | 面板内浮层提示 |
油猴脚本 GM_*
| API | 状态 | 说明 |
|---|---|---|
GM_getValue / GM_setValue / GM_deleteValue / GM_listValues | ✅ | SharedPreferences 支撑,按脚本命名空间 |
GM_xmlhttpRequest | ✅ | 经 OkHttp;完整回调集 |
GM_addStyle | ✅ | |
GM_setClipboard | ✅ | |
GM_openInTab | ✅ | |
GM_log | ✅ | |
GM_getResourceText / GM_getResourceURL | ✅ | |
GM_registerMenuCommand / GM_unregisterMenuCommand | ✅ | 浮窗菜单 |
GM_openScriptWindow / GM_updateScriptWindow / GM_closeScriptWindow | ✅ | WebToApp 专属 |
GM_info | ✅ | |
unsafeWindow | ✅ | 等于 window(无沙箱) |
GM_notification | 🟡 | 仅记录日志;无系统通知 |
@grant 门控 | ⬜ | 无论声明的 grant,所有 API 都暴露 |
GM.*(Promise) | ✅ | 镜像上述全部 |
Chrome chrome.*
| 命名空间 | 状态 | 说明 |
|---|---|---|
runtime | ✅ | 消息、生命周期、getURL、getManifest |
storage | ✅ | local/sync/session;managed no-op |
tabs | ✅ | 核心增删改查 + 事件 |
scripting | ✅ | 动态 content script 注册 |
cookies | ✅ | |
alarms | ✅ | |
declarativeNetRequest | ✅ | block/allow/redirect/modifyHeaders/upgradeScheme |
downloads | 🟡 | download 可用 |
webRequest | 🟡 | onBeforeRequest 经原生桥过滤 |
i18n / notifications / permissions / contextMenus / commands | ✅ | |
webNavigation / extension / idle / tabGroups | 🟡 | |
action / sidePanel | 🟡 | |
windows / management / topSites / fontSettings | ⬜ | 桩 |
identity / history / proxy / privacy | ⬜ | 桩 |
system.cpu/memory/display/storage | ⬜ | 桩 |
bookmarks / offscreen / tts | ⬜ | 桩 |
browserAction / pageAction(MV2) | 🟡 | 兼容别名 |
本表是活文档
可用/桩状态正在逐项核实。有疑问时,请以当前构建实测为准。