JadeView

WebView API（页面控制）

所有操作都针对 window_id（没有单独的 webview 句柄）。WebViewSettings 在 窗口 API 里按字段说明过，这里侧重创建之后还能调什么。

导航与脚本

导航到 URL（navigate_to_url）

让指定窗口里的网页打开另一个地址（http、file、自定义协议等）。

C
int32_t navigate_to_url(uint32_t window_id, const char* url, const char* headers_json);

参数：

  • window_id uint32_t - 目标窗口 id
  • url string - 要导航到的地址
  • headers_json string (可选) - JSON 对象格式的请求头，如 {"Authorization":"Bearer xxx","X-Custom":"value"}。传入 NULL 或空字符串时行为与原 API 一致 (2.2 修改)

后退（webview_go_back）v2.4

C
int32_t webview_go_back(uint32_t window_id);
  • 参数：window_id uint32_t，由 create_webview_window 或 create_borderless_webview_window 返回。
  • 返回值：1 表示指令已进入消息队列，0 表示参数无效或消息队列不可用。

前进（webview_go_forward）v2.4

C
int32_t webview_go_forward(uint32_t window_id);
  • 参数：window_id uint32_t，由 create_webview_window 或 create_borderless_webview_window 返回。
  • 返回值：1 表示指令已进入消息队列，0 表示参数无效或消息队列不可用。

查询是否可后退（webview_can_go_back）v2.4

C
int32_t webview_can_go_back(uint32_t window_id);
  • 参数：window_id uint32_t，目标窗口 id。
  • 返回值：1 表示可以后退，0 表示不可以或窗口不存在。

查询是否可前进（webview_can_go_forward）v2.4

C
int32_t webview_can_go_forward(uint32_t window_id);
  • 参数：window_id uint32_t，目标窗口 id。
  • 返回值：1 表示可以前进，0 表示不可以或窗口不存在。

使用说明

  • 前进 / 后退操作的是 WebView 原生历史栈，对 window.history.pushState 产生的历史条目同样生效。
  • webview_can_go_back / webview_can_go_forward 是同步查询，适合用于更新工具栏按钮状态。
  • 页面刚创建且没有历史记录时，webview_can_go_back() 通常返回 0；建议在 window-created 或 webview-did-finish-load 之后再查询。
  • 同步查询接口不要在 JadeView 事件回调内部调用，避免事件循环线程死锁。
C
uint32_t win = create_webview_window("https://example.com/page-a", 0, NULL, NULL);

/* 等待 webview-did-finish-load 后再调用 */
if (webview_can_go_back(win)) {
    webview_go_back(win);
}

if (webview_can_go_forward(win)) {
    webview_go_forward(win);
}

刷新页面（reload_webview_window）

重新加载当前页，和用户按 F5 类似。

C
int32_t reload_webview_window(uint32_t window_id);

参数：

  • window_id uint32_t - 目标窗口 id

执行 JavaScript（execute_javascript）

往页面里注入并执行一段 JavaScript。

若需要执行结果，通过事件 javascript-result 等取回（见 事件类型）。

C
int32_t execute_javascript(uint32_t window_id, const char* script);

参数：

  • window_id uint32_t - 目标窗口 id
  • script string - 要执行的 JavaScript 代码

返回值：

  • > 0 - 返回的是请求 id，并非 JS 的执行结果；真正的 JS 结果需配合 javascript-result 事件按该 id 取回
  • 0 - script 为 NULL（未提交执行）

设置网页缩放（set_webview_zoom）

整页缩放，例如 1.0 为 100%，1.5 为 150%。

C
int32_t set_webview_zoom(uint32_t window_id, double level);

参数：

  • window_id uint32_t - 目标窗口 id
  • level double - 缩放比例

清除浏览数据（clear_browsing_data） v2.2

清除指定窗口的所有浏览数据（Cookie / 缓存 / LocalStorage 等）。

C
int32_t clear_browsing_data(uint32_t window_id);
  • 参数：window_id uint32_t
  • 返回值：仅表示请求已提交（异步 fire-and-forget），恒返回 1；不代表浏览数据是否真正清除成功

安全控制

设置内容保护（set_content_protection）

打开后，部分截屏/录屏软件较难采到窗口内容（效果因系统和采集方式而异）。

C
int32_t set_content_protection(uint32_t window_id, int32_t content_protection);

参数：

  • window_id uint32_t - 目标窗口 id
  • content_protection int32_t - 非 0 启用保护，0 禁用保护

DevTools v2.2

需在创建窗口时启用 devtools（JadeView_init 的 enable_devmod 参数）。

打开 DevTools（open_devtools） v2.2

C
int32_t open_devtools(uint32_t window_id);
  • 参数：window_id uint32_t
  • 返回值：仅表示请求已提交（异步 fire-and-forget），恒返回 1；不代表 DevTools 是否真正打开

关闭 DevTools（close_devtools） v2.2

C
int32_t close_devtools(uint32_t window_id);
  • 参数：window_id uint32_t
  • 返回值：仅表示请求已提交（异步 fire-and-forget），恒返回 1；不代表 DevTools 是否真正关闭
  • 平台说明：所有平台都会调用，Windows / WebView2 上为 no-op（不报错、仍返回 1）

查询 DevTools 是否打开（is_devtools_open） v2.2

C
int is_devtools_open(uint32_t window_id);
  • 参数：window_id uint32_t
  • 返回值：1 = 已打开，0 = 未打开

打印

打印 WebView 内容（jade_print）

打开系统标准打印对话框，打印当前 WebView 内容。

C
int32_t jade_print(uint32_t window_id);

参数：

  • window_id uint32_t - 目标窗口 id

返回值：

  • 仅表示请求已提交（异步 fire-and-forget），恒返回 1；不代表打印对话框真正弹出或打印成功

运行时信息

获取 WebView 版本（get_webview_version）

读出本机安装的 Microsoft WebView2 运行时版本号（不是 JadeView 版本）。写入 buffer（UTF-8 + \0）。

C
int32_t get_webview_version(char* buffer, size_t buffer_size);

与 工具 API 中的说明一致。

Previous
窗口 API
Next
网页权限