---
title: "dispose"
description: "销毁 Kasumi 桥接、清理事件状态并拒绝所有未完成请求。"
---


> 销毁 Kasumi 桥接、清理事件状态并拒绝所有未完成请求。

## 签名

```ts
KSM.dispose(): void
KSM.shutdown(): void
```

`shutdown()` 是兼容别名，行为与 `dispose()` 完全相同。

## 平台与权限

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

## 参数

无。

## 返回值

`void`。

## 行为

- 解除传输层消息监听。
- 拒绝仍在等待中的 Promise，并清除对应的超时计时器。
- 清空事件监听、订阅跟踪、能力缓存和并发中的能力查询。
- 不调用 `window.close`、`app.exit`，也不会关闭当前窗口。
- 销毁后再次调用模块方法会抛出 `KSM must be initialized before use.`。

## 示例

```ts
KSM.initialize();
await KSM.ping();

KSM.dispose();

//重新进入页面或重新建立桥接时必须再次初始化
KSM.initialize();
```

## 错误

未完成请求会收到普通 `Error`，不会附加 Kasumi 错误码。业务代码不应把销毁期间的
拒绝当成可重试的资源错误。

## 相关

- [initialize](/docs/kasumi/api/core/initialize)
- [events](/docs/kasumi/api/events)