com.auxiliary.selenium.event

Class WaitEvent

java.lang.Object

com.auxiliary.selenium.event.AbstractEvent

com.auxiliary.selenium.event.WaitEvent

public class WaitEvent
extends AbstractEvent

文件名：WaitEvent.java

用途： 定义了对元素进行特殊事件等待的方法，包括等待控件消失、等待控件出现文字等， 可通过该类，等待元素进行一定的变化的操作

编码时间：2020年10月19日上午7:21:05

修改时间：2020年10月19日上午7:21:05

Version:

Ver1.0

Author:

彭宇琦

Field Summary

Fields inherited from class com.auxiliary.selenium.event.AbstractEvent

brower, exceptionSet, isLocationElement, LOCATION_ELEMENT_JS, wait, waitTime, webElement

Constructor Summary

Constructors

Constructor and Description
WaitEvent(AbstractBrower brower) 构造对象
WaitEvent(AbstractBrower brower, long waitTime) 构造对象

Method Summary

Modifier and Type	Method and Description
boolean	appear(Element element) 该方法用于根据元素信息，在元素被加载后，等待元素在页面中出现，并返回元素出现的结果
boolean	disappear(Element element) 用于等待元素消失，若元素无法获取到，则也判定为元素不存在
void	setOvertime(long overtime) 用于设置元素查询超时时间，单位为秒
boolean	showText(Element element, String... keys) 该方法用于等待指定元素中显示相应的文本，可指定显示文本的关键词，直到显示相应的关键词为止， 若不传入关键词，则只判断元素加载出文本。若元素未出现，则返回false

Methods inherited from class com.auxiliary.selenium.event.AbstractEvent

actionOperate, arrayToString, getBrower, getExceptionInfomation, isExistElement, locationElement, setLocationElement, setWaitTime

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WaitEvent

public WaitEvent(AbstractBrower brower)

构造对象

Parameters:

brower - 浏览器AbstractBrower类对象

WaitEvent

public WaitEvent(AbstractBrower brower,
                 long waitTime)

构造对象

Parameters:

brower - 浏览器AbstractBrower类对象

Method Detail

setOvertime

public void setOvertime(long overtime)

用于设置元素查询超时时间，单位为秒

Parameters:

overtime - 超时时间

disappear

public boolean disappear(Element element)

用于等待元素消失，若元素无法获取到，则也判定为元素不存在

Parameters:

element - Element对象

Returns:

元素是否已消失

Throws:

org.openqa.selenium.TimeoutException - 等待超时时抛出的异常

appear

public boolean appear(Element element)

该方法用于根据元素信息，在元素被加载后，等待元素在页面中出现，并返回元素出现的结果

注意：

1. 等待元素出现的超时时间与元素中设置的超时时间一致，与类中超时时间无关
2. 该方法对app元素无效，若等待的元素为app元素，则会抛出UnsupportedCommandException异常

Parameters:

element - Element对象

Returns:

元素是否出现

Throws:

org.openqa.selenium.TimeoutException - 等待超时时抛出的异常

org.openqa.selenium.UnsupportedCommandException - 使用app元素进行等待时抛出的异常

showText

public boolean showText(Element element,
                        String... keys)

该方法用于等待指定元素中显示相应的文本，可指定显示文本的关键词，直到显示相应的关键词为止， 若不传入关键词，则只判断元素加载出文本。若元素未出现，则返回false

Parameters:

element - Element对象

keys - 需要判断的文本

Returns:

元素是否存在文本或包含指定文本

Throws:

org.openqa.selenium.TimeoutException - 等待超时时抛出的异常