【C# 自动化测试】Selenium显式等待机制详解

Suumi.Sun

于 2025-05-20 11:57:34 发布

阅读量425

点赞数 7

分类专栏：软件测试开发文章标签： c# selenium 开发语言

本文链接：https://blog.csdn.net/qingdaoyin/article/details/148084928

版权

软件测试开发专栏收录该内容

7 篇文章

订阅专栏

Selenium显式等待机制详解

一、显式等待的概念

在自动化测试中，等待机制是处理页面元素加载延迟的重要手段。显式等待允许我们在继续执行代码之前等待某个条件发生，这比固定的强制等待更灵活高效。

二、显式等待的实现代码

1. 核心等待方法

/// <summary>  
/// 等待指定元素在页面上显示  
/// </summary>  
/// <param name="pageGUI">页面GUI对象</param>  
/// <param name="by">元素定位方式</param>  
/// <param name="timeout">超时时间(毫秒)</param>  
public void WaitUntilElementShow(PageGUI pageGUI, By by, int timeout)  
{  
    CreateWaitexplicitly(timeout).Until<bool>((d) =>  
    {  
        try  
        {  
            DomElementGUI elementGUI = pageGUI.FindDisplayedElementGUI<DomElementGUI>(by, false);  
            return elementGUI != null;  
        }  
        catch (WebDriverException ex)  
        {  
            // 记录日志或进行其他处理  
            Console.WriteLine($"查找元素时发生异常: {ex.Message}");  
            return false;  
        }  
    });  
}

2. 等待对象创建方法

/// <summary>  
/// 创建显式等待对象  
/// </summary>  
/// <param name="timeout">超时时间(毫秒)</param>  
/// <returns>WebDriverWait对象</returns>  
public WebDriverWait CreateWaitexplicitly(int timeout)  
{  
    WebDriverWait wait = new WebDriverWait(Manager.Current.ActiveBrowser.WebDriver,  
    TimeSpan.FromMilliseconds(timeout))  
    {  
        PollingInterval = new TimeSpan(0, 0, 0, 0, 500) // 调整轮询间隔为500毫秒  
    };  

    // 设置常见的忽略异常  
    wait.IgnoreExceptionTypes(typeof(NoSuchElementException),  
                              typeof(ElementNotVisibleException),  
                              typeof(StaleElementReferenceException));  

    return wait;  
}

3. 方法调用示例

// 等待设计界面中的.wait元素出现，最长等待10秒  
WaitUntilElementShow(DesignGUI, By.CssSelector(".wait"), 10000);

三、WebDriverWait类实现原理

WebDriverWait是Selenium提供的核心等待类，其简化实现如下：

using System;  

namespace OpenQA.Selenium.Support.UI  
{  
    public class WebDriverWait : DefaultWait<IWebDriver>  
    {  
        private static TimeSpan DefaultSleepTimeout => TimeSpan.FromMilliseconds(500);  

        public WebDriverWait(IWebDriver driver, TimeSpan timeout)  
            : this(new SystemClock(), driver, timeout, DefaultSleepTimeout)  
        {  
        }  

        public WebDriverWait(IClock clock, IWebDriver driver, TimeSpan timeout, TimeSpan sleepInterval)  
            : base(driver, clock)  
        {  
            base.Timeout = timeout;  
            base.PollingInterval = sleepInterval;  
            IgnoreExceptionTypes(typeof(NotFoundException));  
        }  
    }  
}

四、显式等待与强制等待对比

1. 强制等待的缺点

// 强制等待示例 - 存在明显缺陷  
Thread.Sleep(5000); // 固定等待5秒

强制等待通过Thread.Sleep()实现固定时间等待，存在以下问题：

效率低下：无论元素是否已加载，都需等待固定时间。
可靠性差：
- 为保证用例通过率，通常需将等待时间设置为网络较慢时的极限值，这会显著拉长整个用例集的运行时间。
- 当用例集运行期间发生短暂断网或网络较慢时，容易导致大量用例因元素未及时加载而大面积失败。
维护成本高：需为不同操作单独调整等待时间，代码冗余度高。