---
title: "ping"
description: "验证前端桥接、WebView 传输和宿主路由是否连通。"
---


> 验证前端桥接、WebView 传输和宿主路由是否连通。

## 签名

```ts
KSM.ping(): Promise<{ pong: true }>
```

## 平台与权限

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

## 参数

无。

## 返回值

|字段 |类型 |说明 |
| --- | --- | --- |
| `pong` | `true` |宿主已收到并处理请求 |

## 行为

`ping` 不读写文件、不访问系统权限，适合在初始化后做最小通路检查。
请求遵循默认 10 秒超时。

## 示例

```ts
KSM.initialize();

const { pong } = await KSM.ping();
console.assert(pong === true);
```

## 错误

|错误 |场景 |
| --- | --- |
|普通 `Error` |桥接尚未初始化或已销毁 |
| `TIMEOUT` |宿主未在默认时间内响应 |
| `UNKNOWN_COMMAND` |自定义宿主没有注册 `ping` |

## 相关

- [capabilities](/docs/kasumi/api/core/capabilities)
- [errors](/docs/kasumi/api/errors)