---
title: "close"
description: "请求关闭当前应用窗口。"
---


> 请求关闭当前应用窗口。

## 签名

```ts
KSM.window.close(): Promise<{ closed: boolean }>
```

## 平台与权限

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

## 参数

无。

## 返回值

|字段 |类型 |说明 |
| --- | --- | --- |
| `closed` | `boolean` |宿主是否接受关闭请求 |

## 行为

- Windows 向窗口投递 `WM_CLOSE`。
- Android 在 UI 线程调用 `Activity.finish()`。
- 返回值表示请求已提交，不保证窗口已经销毁。
- 关闭前应完成数据保存并停止后续调用。

## 示例

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

await KSM.window.close();
```

## 错误

|错误 |场景 |
| --- | --- |
| `PERMISSION_DENIED` | `window.control` 不可用 |
| `NOT_SUPPORTED` |宿主没有配置窗口服务 |
| `TIMEOUT` |宿主未在默认时间内响应 |

## 相关

- [app.exit](/docs/kasumi/api/app/exit)
- [window 模块](/docs/kasumi/api/window)