com.auxiliary.selenium.event

Class AssertEvent

java.lang.Object

com.auxiliary.selenium.event.AbstractEvent

com.auxiliary.selenium.event.AssertEvent

public class AssertEvent
extends AbstractEvent

文件名：AssertEvent.java

用途： 定义了对控件进行断言的方法，可通过该类，对页面元素进行断言操作。类中的所有断言均以 boolean类型进行返回，可通过类中提供的方法指定当断言失败时，是否抛出一个异常，默认 不抛出异常。

编码时间：2020年10月20日上午7:48:05

修改时间：2021年10月18日 上午10:25:01

Since:

JDK 1.8

Version:

Ver1.0

Author:

彭宇琦

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	AssertEvent.SeleniumAssertException 文件名：AssertEvent.java

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
AssertEvent(AbstractBrower brower) 构造对象

Method Summary

Modifier and Type	Method and Description
boolean	assertAttributeContainKey(Element element, String attributeName, boolean isJudgeAllKey, String... keys) 断言元素的指定属性是否包含指定的关键词。可设置元素的文本内容是否需要判断传入的所有关键词， 具体参数介绍可参考assertTextContainKey(Element, boolean, String...)方法
boolean	assertAttributeNotContainKey(Element element, String attributeName, boolean isJudgeAllKey, String... keys) 断言元素的文本内容中不包含指定的关键词。可设置元素的文本内容是否需要判断传入的所有关键词， 具体参数介绍可参考assertTextNotContainKey(Element, boolean, String...)方法
boolean	assertElementsNumber(Element referencedElement, CompareNumberType compareNumberType, Element comparativeElement) 断言两元素中的数字内容，按照CompareNumberType指定的比较类型进行比较。若断言的 元素文本内容存在非数字字符时，则直接断言失败
boolean	assertEqualsElementText(Element referencedElement, Element comparativeElement) 断言两个元素内文本一致
boolean	assertEqualsText(Element element, String text) 用于断言元素的内容与预期的文本一致
boolean	assertExistElement(Element element) 断言元素存在
boolean	assertNotEqualsElementText(Element referencedElement, Element comparativeElement) 断言两个元素内文本不一致
boolean	assertNotEqualsText(Element element, String text) 用于断言元素的内容与传入的文本不一致
boolean	assertNotExistElement(Element element) 断言元素不存在
boolean	assertNumber(Element element, CompareNumberType compareNumberType, double compareNumber) 断言元素中的数字内容与指定的数字按照CompareNumberType指定的比较类型进行比较。若断言的 元素文本内容为非数字字符时，则直接断言失败
boolean	assertTextContainKey(Element element, boolean isJudgeAllKey, String... keys) 断言元素的文本内容中包含指定的关键词。可设置元素的文本内容是否需要判断传入的所有关键词，即 当需要完全判断时，则当且仅当文本包含所有关键词时，断言方法返回true 当不需要完全判断时，则当前仅当文本不包含所有关键词时，断言方法返回false
boolean	assertTextContainKey(Element element, Function<Element,String> dispose, boolean isJudgeAllKey, String... keys) 对元素内容进行处理，并断言处理后的文本内容中包含指定的关键词。 可设置元素的文本内容是否需要判断传入的所有关键词，具体参数介绍 可参考assertTextContainKey(Element, boolean, String...)方法
boolean	assertTextNotContainKey(Element element, boolean isJudgeAllKey, String... keys) 断言元素的文本内容中不包含指定的关键词。可设置元素的文本内容是否需要判断传入的所有关键词，即 当需要完全判断时，则当且仅当文本不包含所有关键词时，断言方法返回true 当不需要完全判断时，则当前仅当文本包含所有关键词时，断言方法返回false
boolean	assertTextNotContainKey(Element element, Function<Element,String> dispose, boolean isJudgeAllKey, String... keys) 对元素内容进行处理，并断言处理后的文本内容中不包含指定的关键词。 可设置元素的文本内容是否需要判断传入的所有关键词， 具体参数介绍可参考assertTextContainKey(Element, boolean, String...)方法
void	setThrowException(boolean isThrowException) 设置当前断言失败时，是否抛出一个异常，默认为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

AssertEvent

public AssertEvent(AbstractBrower brower)

构造对象

Parameters:

brower - 浏览器AbstractBrower类对象

Method Detail

setThrowException

public void setThrowException(boolean isThrowException)

设置当前断言失败时，是否抛出一个异常，默认为false，即不抛出异常

Parameters:

isThrowException - 是否抛出异常

assertTextContainKey

public boolean assertTextContainKey(Element element,
                                    boolean isJudgeAllKey,
                                    String... keys)

断言元素的文本内容中包含指定的关键词。可设置元素的文本内容是否需要判断传入的所有关键词，即

• 当需要完全判断时，则当且仅当文本包含所有关键词时，断言方法返回true
• 当不需要完全判断时，则当前仅当文本不包含所有关键词时，断言方法返回false

例如,假设元素中存在文本“你好，世界！”，则

• 需要判断的关键词为["你好", "Java"]时：
  1. 需要判断所有文本，此时断言方法返回false
  2. 不需要判断所有文本，此时断言方法返回true
• 需要判断的关键词为["你好", "世界"]时：
  1. 需要判断所有文本，此时断言方法返回true
  2. 不需要判断所有文本，此时断言方法返回true
• 需要判断的关键词为["Hello", "Java"]时：
  1. 需要判断所有文本，此时断言方法返回false
  2. 不需要判断所有文本，此时断言方法返回false

注意：若不传入关键词，或关键词为null时，则返回true

Parameters:

element - Element对象

isJudgeAllKey - 是否需要完全判断所有关键词

keys - 关键词组

Returns:

断言结果

Throws:

org.openqa.selenium.TimeoutException - 元素无法操作时抛出的异常

org.openqa.selenium.NoSuchElementException - 元素不存在或下标不正确时抛出的异常

assertTextNotContainKey

public boolean assertTextNotContainKey(Element element,
                                       boolean isJudgeAllKey,
                                       String... keys)

断言元素的文本内容中不包含指定的关键词。可设置元素的文本内容是否需要判断传入的所有关键词，即

• 当需要完全判断时，则当且仅当文本不包含所有关键词时，断言方法返回true
• 当不需要完全判断时，则当前仅当文本包含所有关键词时，断言方法返回false

例如,假设元素中存在文本“你好，世界！”，则

• 需要判断的关键词为["你好", "Java"]时：
  1. 需要判断所有文本，此时断言方法返回false
  2. 不需要判断所有文本，此时断言方法返回true
• 需要判断的关键词为["你好", "世界"]时：
  1. 需要判断所有文本，此时断言方法返回false
  2. 不需要判断所有文本，此时断言方法返回false
• 需要判断的关键词为["Hello", "Java"]时：
  1. 需要判断所有文本，此时断言方法返回true
  2. 不需要判断所有文本，此时断言方法返回true

注意：若不传入关键词，或关键词为null时，则返回true

Parameters:

element - Element对象

isJudgeAllKey - 是否需要完全判断所有关键词

keys - 关键词组

Returns:

断言结果

Throws:

org.openqa.selenium.TimeoutException - 元素无法操作时抛出的异常

org.openqa.selenium.NoSuchElementException - 元素不存在或下标不正确时抛出的异常

assertAttributeContainKey

public boolean assertAttributeContainKey(Element element,
                                         String attributeName,
                                         boolean isJudgeAllKey,
                                         String... keys)

断言元素的指定属性是否包含指定的关键词。可设置元素的文本内容是否需要判断传入的所有关键词， 具体参数介绍可参考assertTextContainKey(Element, boolean, String...)方法

Parameters:

element - Element对象

attributeName - 属性名称

isJudgeAllKey - 是否需要完全判断所有关键词

keys - 关键词组

Returns:

断言结果

Throws:

org.openqa.selenium.TimeoutException - 元素无法操作时抛出的异常

org.openqa.selenium.NoSuchElementException - 元素不存在或下标不正确时抛出的异常

assertAttributeNotContainKey

public boolean assertAttributeNotContainKey(Element element,
                                            String attributeName,
                                            boolean isJudgeAllKey,
                                            String... keys)

断言元素的文本内容中不包含指定的关键词。可设置元素的文本内容是否需要判断传入的所有关键词， 具体参数介绍可参考assertTextNotContainKey(Element, boolean, String...)方法

Parameters:

element - Element对象

attributeName - 属性名称

isJudgeAllKey - 是否需要完全判断所有关键词

keys - 关键词组

Returns:

断言结果

Throws:

org.openqa.selenium.TimeoutException - 元素无法操作时抛出的异常

org.openqa.selenium.NoSuchElementException - 元素不存在或下标不正确时抛出的异常

assertTextContainKey

public boolean assertTextContainKey(Element element,
                                    Function<Element,String> dispose,
                                    boolean isJudgeAllKey,
                                    String... keys)

对元素内容进行处理，并断言处理后的文本内容中包含指定的关键词。 可设置元素的文本内容是否需要判断传入的所有关键词，具体参数介绍 可参考assertTextContainKey(Element, boolean, String...)方法

Parameters:

element - Element对象

dispose - 对元素内容的处理方法，传入的参数为Element对象，返回的参数为字符串

isJudgeAllKey - 是否需要完全判断所有关键词

keys - 关键词组

Returns:

断言结果

Throws:

org.openqa.selenium.TimeoutException - 元素无法操作时抛出的异常

org.openqa.selenium.NoSuchElementException - 元素不存在或下标不正确时抛出的异常

assertTextNotContainKey

public boolean assertTextNotContainKey(Element element,
                                       Function<Element,String> dispose,
                                       boolean isJudgeAllKey,
                                       String... keys)

对元素内容进行处理，并断言处理后的文本内容中不包含指定的关键词。 可设置元素的文本内容是否需要判断传入的所有关键词， 具体参数介绍可参考assertTextContainKey(Element, boolean, String...)方法

Parameters:

element - Element对象

dispose - 对元素内容的处理方法，传入的参数为Element对象，返回的参数为字符串

isJudgeAllKey - 是否需要完全判断所有关键词

keys - 关键词组

Returns:

断言结果

Throws:

org.openqa.selenium.TimeoutException - 元素无法操作时抛出的异常

org.openqa.selenium.NoSuchElementException - 元素不存在或下标不正确时抛出的异常

assertEqualsText

public boolean assertEqualsText(Element element,
                                String text)

用于断言元素的内容与预期的文本一致

Parameters:

element - Element对象

text - 需要判断的文本内容

Returns:

断言结果

Throws:

org.openqa.selenium.TimeoutException - 元素无法操作时抛出的异常

org.openqa.selenium.NoSuchElementException - 元素不存在或下标不正确时抛出的异常

assertNotEqualsText

public boolean assertNotEqualsText(Element element,
                                   String text)

用于断言元素的内容与传入的文本不一致

Parameters:

element - Element对象

text - 需要判断的文本内容

Returns:

断言结果

Throws:

org.openqa.selenium.TimeoutException - 元素无法操作时抛出的异常

org.openqa.selenium.NoSuchElementException - 元素不存在或下标不正确时抛出的异常

assertEqualsElementText

public boolean assertEqualsElementText(Element referencedElement,
                                       Element comparativeElement)

断言两个元素内文本一致

Parameters:

referencedElement - 参考元素

comparativeElement - 比较元素

Returns:

断言结果

Throws:

org.openqa.selenium.TimeoutException - 元素无法操作时抛出的异常

org.openqa.selenium.NoSuchElementException - 元素不存在或下标不正确时抛出的异常

assertNotEqualsElementText

public boolean assertNotEqualsElementText(Element referencedElement,
                                          Element comparativeElement)

断言两个元素内文本不一致

Parameters:

referencedElement - 参考元素

comparativeElement - 比较元素

Returns:

断言结果

Throws:

org.openqa.selenium.TimeoutException - 元素无法操作时抛出的异常

org.openqa.selenium.NoSuchElementException - 元素不存在或下标不正确时抛出的异常

assertExistElement

public boolean assertExistElement(Element element)

断言元素存在

Parameters:

element - Element对象

Returns:

断言结果

assertNotExistElement

public boolean assertNotExistElement(Element element)

断言元素不存在

Parameters:

element - Element对象

Returns:

断言结果

assertElementsNumber

public boolean assertElementsNumber(Element referencedElement,
                                    CompareNumberType compareNumberType,
                                    Element comparativeElement)

断言两元素中的数字内容，按照CompareNumberType指定的比较类型进行比较。若断言的 元素文本内容存在非数字字符时，则直接断言失败

Parameters:

referencedElement - 参考元素

compareNumberType - 比较方式CompareNumberType枚举类

comparativeElement - 比较元素

Returns:

断言结果

assertNumber

public boolean assertNumber(Element element,
                            CompareNumberType compareNumberType,
                            double compareNumber)

断言元素中的数字内容与指定的数字按照CompareNumberType指定的比较类型进行比较。若断言的 元素文本内容为非数字字符时，则直接断言失败

Parameters:

element - Element对象

compareNumberType - 比较方式CompareNumberType枚举类

compareNumber - 预期数字

Returns:

断言结果