---
title: "webview.reloaded"
description: "WebView 页面重建后由宿主主动发送的系统事件。"
---


> WebView 页面重建后由宿主主动发送的系统事件。

## 签名

```ts
KSM.events.on<Record<string, never>>(
  'webview.reloaded',
  (payload) => void
): () => void
```

## 平台与权限

| Windows | Android |权限 |
| --- | --- | --- |
|支持 |支持 |无 |

## 载荷

|字段 |类型 |说明 |
| --- | --- | --- |
|无 |空对象 |当前没有业务字段 |

## 行为

- 由宿主在 WebView 加载完成后主动发送，不依赖 `event.subscribe`。
- 前端桥接内部监听该事件并执行恢复。
- 恢复会丢弃旧请求、刷新能力，并重新订阅重建前跟踪的普通事件。
- 普通业务监听器不参与这段内部恢复流程。
- 页面不应自行发送同名事件，也不能用事件伪造宿主重建状态。

## 示例

通常无需业务监听。只有需要记录诊断信息时才注册：

```ts
const off = KSM.events.on(
  'webview.reloaded',
  () => console.info('WebView 已重建')
);

off();
```

## 错误

系统事件由宿主发送，没有对应的命令返回值。桥接层销毁后不会再收到该事件。

## 相关

- [events 模块](/docs/kasumi/api/events)
- [capabilities](/docs/kasumi/api/core/capabilities)