统一控制延时

This commit is contained in:
2026-07-30 15:29:24 +08:00
parent bfe13d300b
commit 66bca74267
11 changed files with 148 additions and 113 deletions
+13
View File
@@ -101,3 +101,16 @@ src/
- 禁止对 isAsyncDropdown 字段走 `tryClickDropdownListItem` 全页面搜(选项数可能为1,全页面搜会被其他同规格元素干扰)
- `pickerFill.ts``groupBySpec` / `findVisibleListGroups` 的同规格标签组阈值为 ≥2(不可改回 ≥3,否则只有2个选项的下拉列表会漏匹配)
- `clickBestOptionInDropdown` 是在指定弹出层 DOM 内递归搜所有可见叶子文字节点做模糊匹配的核心方法,**不可简化其递归逻辑**
## 延时调用规范
- **项目中所有延时调用必须且只能使用 `src/utils/delay.ts` 中导出的 `delay` 函数**
- 禁止在任何文件中自行编写 `setTimeout` / `new Promise(resolve => setTimeout(...))` 等延时逻辑
- `delay` 函数接收延时等级参数,统一管理延时时长:
- `delay("low")` — 低延时(微等待,如点击后极短暂停)
- `delay("mid")` — 中延时(等待 DOM 更新、弹出层渲染等)
- `delay("high")` — 高延时(等待接口返回、搜索结果、动画完成等)
- `delay("max")` — 特殊超长延时(谨慎使用)
- 具体毫秒数只在 `src/utils/delay.ts` 中统一设置,调用方只使用等级名称
- 如需调整全局延时策略,只修改 `delay.ts` 中的 `DELAY_MS` 常量即可