@zturnlibs/ztron-api

---

webview#

Classes#

Webview#

Defined in: webview.ts:10

窗口内嵌 Web 内容的 webview 层控制。

Constructors#

Constructor#

new Webview(label): Webview

Defined in: webview.ts:13

Parameters#

label#

string

Returns#

Webview

Properties#

label#

readonly label: string

Defined in: webview.ts:11

Methods#

clearAllBrowsingData()#

clearAllBrowsingData(): Promise<void>

Defined in: webview.ts:97

清空该 webview 存储的全部浏览数据：cookies、缓存、本地/会话存储、IndexedDB（WKWebsiteDataStore / WebView2 profile 等价物）。

Returns#

Promise<void>

close()#

close(): Promise<void>

Defined in: webview.ts:142

关闭该 webview 所属的窗口。

Returns#

Promise<void>

hide()#

hide(): Promise<void>

Defined in: webview.ts:132

隐藏该 webview 的窗口。

Returns#

Promise<void>

position()#

position(): Promise<{ x: number; y: number; }>

Defined in: webview.ts:60

webview 位置（单 webview 时代与所属窗口外框位置一致——裸多 webview 拆分于 G7 落地）。

Returns#

Promise<{ x: number; y: number; }>

print()#

print(): Promise<void>

Defined in: webview.ts:31

打开页面打印对话框（wry 对齐：委托给页面自身的 window.print()）。

Returns#

Promise<void>

setBackgroundColor()#

setBackgroundColor(color): Promise<void>

Defined in: webview.ts:36

webview 层背景色（单 webview 时代：窗口表面）。

Parameters#

color#

string

Returns#

Promise<void>

setFocus()#

setFocus(): Promise<void>

Defined in: webview.ts:127

聚焦该 webview（其窗口的按键状态）。

Returns#

Promise<void>

setPosition()#

setPosition(x, y): Promise<void>

Defined in: webview.ts:109

在窗口内定位 webview 内容（无 reparent）。

Parameters#

x#

number

y#

number

Returns#

Promise<void>

setSize()#

setSize(width, height): Promise<void>

Defined in: webview.ts:118

在窗口内调整 webview 内容尺寸。

Parameters#

width#

number

height#

number

Returns#

Promise<void>

setZoom()#

setZoom(zoom): Promise<void>

Defined in: webview.ts:147

设置 Web 内容缩放系数（CSS zoom）。

Parameters#

zoom#

number

Returns#

Promise<void>

show()#

show(): Promise<void>

Defined in: webview.ts:137

显示该 webview 的窗口。

Returns#

Promise<void>

size()#

size(): Promise<{ height: number; width: number; }>

Defined in: webview.ts:65

webview 尺寸（与窗口一致；见 Webview.position）。

Returns#

Promise<{ height: number; width: number; }>

toggleDevtools()#

toggleDevtools(): Promise<{ platform: string; reason?: string; supported: boolean; }>

Defined in: webview.ts:48

切换检查器。上游对齐注记：macOS WKWebView 无公开切换接口（调试构建默认启用），host 会在该平台如实上报 supported: false 而非静默失败。

Returns#

Promise<{ platform: string; reason?: string; supported: boolean; }>

window()#

window(): Window

Defined in: webview.ts:104

所属窗口句柄（webview 控制常镜像窗口操作）。

Returns#

Window

capabilities()#

static capabilities(): Promise<{ autoResize: boolean; multipleWebviewsPerWindow: boolean; perWindow: boolean; reparent: boolean; }>

Defined in: webview.ts:83

host webview 能力图（G7）：本后端每窗口一个 webview；同窗多 webview/reparent/autoResize 如实上报为 false 而非静默空操作。

Returns#

Promise<{ autoResize: boolean; multipleWebviewsPerWindow: boolean; perWindow: boolean; reparent: boolean; }>

getByLabel()#

static getByLabel(label): Promise<Webview | null>

Defined in: webview.ts:73

按 label 查找 webview。一窗一 webview 时代，webview 存在当且仅当其窗口存在。

Parameters#

label#

string

Returns#

Promise<Webview | null>

getCurrent()#

static getCurrent(): Webview

Defined in: webview.ts:18

当前 webview（label 来自引导元数据）。

Returns#

Webview

Functions#

getAllWebviews()#

getAllWebviews(): Promise<Webview[]>

Defined in: webview.ts:156

以 Webview 句柄列出全部存活 webview。

Returns#

Promise<Webview[]>

---

getCurrentWebview()#

getCurrentWebview(): Webview

Defined in: webview.ts:166

Webview.getCurrent 的上游命名别名。

Returns#

Webview