> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt.

# hookTimeout

- **类型：** `number`
- **默认值：** `10_000`
- **CLI：** `--hookTimeout=10000`

单个测试 [hook](/zh/api/runtime-api/test-api/hooks.md) 的超时时间（毫秒）。设置为 `0` 禁用超时。


**CLI**

```bash
npx rstest --hookTimeout=10000
```


**rstest.config.ts**

```ts
import { defineConfig } from '@rstest/core';

export default defineConfig({
  hookTimeout: 10000,
});
```


Rstest 会根据以下优先级顺序确定 hook 超时时间：

1. 每个测试用例中的 [timeout](/zh/api/runtime-api/test-api/hooks.md) 配置
2. 测试文件中通过 [`rs.setConfig({ hookTimeout })`](/zh/api/runtime-api/rstest/utilities.md#rssetconfig) 配置的超时时间
3. CLI 中的 `--hookTimeout` 选项
4. 配置文件中的 `hookTimeout` 选项
5. 默认值 `10_000` 毫秒