---
title: "setTitle"
description: "设置当前 Windows 窗口标题。"
---


> 设置当前 Windows 窗口标题。

## 签名

```ts
KSM.window.setTitle(title: string): Promise<{ updated: boolean }>
```

## 平台与权限

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

Android 调用该命令返回 `NOT_SUPPORTED`，能力列表也不包含 `window.setTitle`。

## 参数

|参数 |类型 |必填 |说明 |
| --- | --- | --- | --- |
| `title` | `string` |是 |新窗口标题 |

## 返回值

|字段 |类型 |说明 |
| --- | --- | --- |
| `updated` | `boolean` |系统是否接受标题更新 |

## 行为

- Windows 调用 `SetWindowTextW`。
- 窗口句柄不可用或系统拒绝更新时返回 `{ updated: false }`。
- 不修改应用名、HTML 文档标题或系统任务栏分组名称。

## 示例

```ts
const { updated } = await KSM.window.setTitle('Kasumi -设置');

if (!updated) {
  console.info('窗口标题未更新');
}
```

## 错误

|错误 |场景 |
| --- | --- |
|普通 `TypeError` |标题不是字符串 |
| `PERMISSION_DENIED` | `window.control` 不可用 |
| `NOT_SUPPORTED` | Android 或宿主没有配置窗口服务 |

## 相关

- [window 模块](/docs/kasumi/api/window)
- [close](/docs/kasumi/api/window/close)