---
title: "exit"
description: "请求宿主退出当前应用。"
---


> 请求宿主退出当前应用。

## 签名

```ts
KSM.app.exit(): Promise<{ exited: boolean }>
```

命名导出也可写为 `app.exit()`，底层调用 `app.exit` 命令。

## 平台与权限

| Windows | Android |权限 |
| --- | --- | --- |
|支持 |支持 | `window.control` |

## 参数

无。

## 返回值

|字段 |类型 |说明 |
| --- | --- | --- |
| `exited` | `boolean` |宿主是否接受退出请求 |

## 行为

- Windows 通过窗口关闭消息发起退出，返回消息是否投递成功。
- Android 在 UI 线程调用 `finishAffinity()`，返回请求是否已提交。
- 返回值不保证进程已经结束；不要依赖下一行代码继续完成持久化。
- 退出前需要保存的数据应在本方法调用前完成写入。

## 示例

```ts
await KSM.fs.writeText({
  path: 'app://data/session.json',
  content: JSON.stringify({ closedAt: Date.now() })
});

await KSM.app.exit();
```

## 错误

|错误 |场景 |
| --- | --- |
| `PERMISSION_DENIED` | `window.control` 不可用 |
| `NOT_SUPPORTED` |宿主没有配置应用服务 |
| `TIMEOUT` |宿主未及时响应 |

## 相关

- [window.close](/docs/kasumi/api/window/close)
- [permission.request](/docs/kasumi/api/permission/request)