以下是关于go-rod中等待机制的总结博文：

掌握go-rod中的等待机制：高效处理异步页面加载

在浏览器自动化中，正确处理页面加载和异步操作是保证脚本稳定性的关键。go-rod 提供了一系列灵活的等待机制，帮助开发者精准控制操作时序。本文将深入解析这些机制，并附示例代码。

1. 基础等待方法

1.1 WaitLoad - 等待页面加载完成

等待页面主框架加载完毕（DOMContentLoaded事件触发）及网络请求空闲。

page := browser.MustPage()
page.MustNavigate("https://example.com").MustWaitLoad()

1.2 WaitIdle - 等待完全空闲

等待所有网络请求和JS执行完成（比WaitLoad更严格）。

page.MustWaitIdle()

1.3 WaitStable - 等待元素稳定

持续监控元素，直到其位置/尺寸在指定时间内不再变化。

el.MustWaitStable(500 * time.Millisecond)

2. 元素级等待

2.1 可见性控制

// 等待元素可见（默认超时）
el.MustWaitVisible()

// 自定义超时（30秒）
el.Timeout(30 * time.Second).MustWaitVisible()

// 等待元素隐藏
el.MustWaitInvisible()

2.2 状态检测

// 等待元素可交互
el.MustWaitEnabled()

// 等待元素禁用
el.MustWaitDisabled()

// 等待元素包含指定文本
el.MustWaitContainsText("Loading complete")

3. 高级等待策略

3.1 自定义条件等待

使用Wait方法配合判断函数：

// 等待页面标题变为指定内容
page.MustWait(func() bool {
    return page.MustInfo().Title == "Success Page"
})

// 带超时的自定义等待
err := rod.Try(func() {
    page.Timeout(10 * time.Second).Wait(func(p *rod.Page) bool {
        return p.MustHas("[data-loaded=true]")
    })
})

3.2 重试机制

// 重试操作直到成功或超时
err := rod.Retry(5, 2*time.Second, func() (bool, error) {
    exists := page.MustHas(".retry-btn")
    return exists, nil
})

4. 超时控制

4.1 全局超时设置

// 页面级超时
page.Timeout(30 * time.Second).MustNavigate(url)

// 元素级超时
el.Timeout(15 * time.Second).MustClick()

4.2 动态超时调整

// 禁用超时（谨慎使用）
page = page.Timeout(-1)
defer page.CancelTimeout() // 恢复默认

5. 最佳实践

1. 优先使用显式等待：避免time.Sleep硬性等待
2. 组合使用策略：例如先WaitLoad再WaitIdle
3. 合理设置超时：根据网络环境和页面复杂度调整
4. 配合重试机制：处理偶发性加载失败

5. 监控控制台错误：

   go page.EachEvent(func(e *proto.RuntimeConsoleAPICalled) {
       log.Printf("Console: %s", proto.GetType(e.Type))
   })()

6. 常见问题场景

场景1：动态加载内容

// 等待新增元素出现
page.MustWaitRequestIdle().MustWaitIdle()
page.MustElementR("div.result", "Data loaded")

场景2：文件下载检测

wait := page.WaitDownload()
page.MustClick("#export-btn")
file := wait()

场景3：跨页面导航

// 等待新页面加载
newPage := page.MustWaitOpen().MustPage()

结语

go-rod通过丰富的等待机制，为不同场景提供了细粒度的控制能力。合理运用这些方法可以显著提升脚本的健壮性和执行效率。建议根据实际需求组合使用多种策略，并配合适当的错误处理机制，构建可靠的浏览器自动化流程。

完整示例代码参考：go-rod官方文档

希望这篇总结能帮助您更好地驾驭go-rod的等待机制！如有特定场景需要深入探讨，欢迎进一步交流。