com.auxiliary.selenium.event

Class TextEvent

java.lang.Object

com.auxiliary.selenium.event.AbstractEvent

com.auxiliary.selenium.event.TextEvent

public class TextEvent
extends AbstractEvent

文件名：TextEvent.java

用途：定义了对控件文本操作相关的方法，可通过该类，对页面进行对控件输入，文本获取等操作

编码时间：2019年9月6日上午9:28:59

修改时间：2021年10月18日 上午11:37:14

Since:

JDK 1.8

Version:

Ver2.1

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

Method Summary

Modifier and Type	Method and Description
String	clear(Element element) 该方法通过控件名称或定位方式对页面元素进行定位来清空控件中的内容，主要用于清空文本框中已有的数据。该方法将存储被清空的 文本
String	getAttributeValue(Element element, String attributeName) 用于获取元素中的指定属性值的内容
String	getImageText(Element element) 用于对“数字+英文”类型的图片内容进行识别的方法，根据图片元素位置，识别图片中的内容。 注意，该方法识别成功的概率不高，在“数字+英文”的模式下，经常将数字识别为英文。
String	getText(Element element) 用于获取相应元素中的文本内容
String	input(Element element, String text) 用于在指定的控件中输入相应的内容
String	keyToSend(Element element, KeyType... keyTypes) 用于向页面上发送键盘按键
String	updataFile(Element element, File updataFile) 用于向控件中上传指定的文件。

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

TextEvent

public TextEvent(AbstractBrower brower)

构造对象

Parameters:

brower - 浏览器AbstractBrower类对象

Method Detail

clear

public String clear(Element element)

该方法通过控件名称或定位方式对页面元素进行定位来清空控件中的内容，主要用于清空文本框中已有的数据。该方法将存储被清空的 文本

Parameters:

element - Element对象

Returns:

被清空的文本内容

Throws:

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

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

getAttributeValue

public String getAttributeValue(Element element,
                                String attributeName)

用于获取元素中的指定属性值的内容

Parameters:

element - Element对象

attributeName - 属性名称

Returns:

对应属性的值

Throws:

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

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

getText

public String getText(Element element)

用于获取相应元素中的文本内容

Parameters:

element - Element对象

Returns:

对应元素中的文本内容

Throws:

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

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

input

public String input(Element element,
                    String text)

用于在指定的控件中输入相应的内容

Parameters:

element - Element对象

text - 需要输入到控件中的内容

Returns:

在控件中输入的内容

Throws:

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

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

keyToSend

public String keyToSend(Element element,
                        KeyType... keyTypes)

用于向页面上发送键盘按键

Parameters:

element - Element对象

keyTypes - 需要传入的按键枚举（KeyType枚举类）

Returns:

发送按键组合，每个按键间用“ + ”字符串连接

Throws:

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

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

Since:

autest 3.1.0

getImageText

public String getImageText(Element element)

用于对“数字+英文”类型的图片内容进行识别的方法，根据图片元素位置，识别图片中的内容。 注意，该方法识别成功的概率不高，在“数字+英文”的模式下，经常将数字识别为英文。

Parameters:

element - 图片元素

Returns:

识别图片的结果

updataFile

public String updataFile(Element element,
                         File updataFile)

用于向控件中上传指定的文件。

Parameters:

element - Element对象

updataFile - 需要上传到控件中的文件

Returns:

上传的文件路径

Throws:

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

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