聊聊selenium的webdriver的超时参数

测试积点老人

序

本文主要介绍下selenium的webdriver的超时参数。

超时参数

selenium-api-2.53.1-sources.jar!/org/openqa/selenium/WebDriver.java

1. /**
   
2.    * An interface for managing timeout behavior for WebDriver instances.
   
3.    */
   
4.   interface Timeouts {
   
5. 
   
6.     /**
   
7.      * Specifies the amount of time the driver should wait when searching for an element if it is
   
8.      * not immediately present.
   
9.      * <p>
   
10.      * When searching for a single element, the driver should poll the page until the element has
    
11.      * been found, or this timeout expires before throwing a {[url=home.php?mod=space&uid=26824]@link[/url] NoSuchElementException}. When
    
12.      * searching for multiple elements, the driver should poll the page until at least one element
    
13.      * has been found or this timeout has expired.
    
14.      * <p>
    
15.      * Increasing the implicit wait timeout should be used judiciously as it will have an adverse
    
16.      * effect on test run time, especially when used with slower location strategies like XPath.
    
17.      *
    
18.      * @param time The amount of time to wait.
    
19.      * @param unit The unit of measure for {[url=home.php?mod=space&uid=21701]@code[/url] time}.
    
20.      * @return A self reference.
    
21.      */
    
22.     Timeouts implicitlyWait(long time, TimeUnit unit);
    
23. 
    
24.     /**
    
25.      * Sets the amount of time to wait for an asynchronous script to finish execution before
    
26.      * throwing an error. If the timeout is negative, then the script will be allowed to run
    
27.      * indefinitely.
    
28.      *
    
29.      * @param time The timeout value.
    
30.      * @param unit The unit of time.
    
31.      * @return A self reference.
    
32.      * @see JavascriptExecutor#executeAsyncScript(String, Object...)
    
33.      */
    
34.     Timeouts setScriptTimeout(long time, TimeUnit unit);
    
35. 
    
36.     /**
    
37.      * Sets the amount of time to wait for a page load to complete before throwing an error.
    
38.      * If the timeout is negative, page loads can be indefinite.
    
39.      *
    
40.      * @param time The timeout value.
    
41.      * @param unit The unit of time.
    
42.      * @return A Timeouts interface.
    
43.      */
    
44.     Timeouts pageLoadTimeout(long time, TimeUnit unit);
    
45.   }
    

复制代码

implicitlyWait

相当于设置全局的等待，在定位元素时，对所有元素设置超时时间，超出了设置时间则抛出异常。默认为0即不等待。

An implicit wait is to tell WebDriver to poll the DOM for a certain amount of time when trying to find an element or elements if they are not immediately available. The default setting is 0. Once set, the implicit wait is set for the life of the WebDriver object instance. 没有设置implicitlyWait，则driver.findElement()只会找一遍指定元素，找不到就马上抛异常

pageLoadTimeout

用来设置页面完全加载的超时时间，完全加载即页面全部渲染。超过这个时间则抛出异常。默认为-1，即永不超时。

Sets the amount of time to wait for a page load to complete before throwing an error. If the timeout is negative, page loads can be indefinite.

这里是否包含异步脚本都执行完成呢，一般onload是指外部资源加载完，而异步脚本执行完跟这个应该不是一回事。