【Katalon学习Web UI】元素操作

Click

单击给定的元素。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
flowControl	FailureHandling	Optional	指定failure handlingschema以确定是否应该允许执行继续或停止.

 

Click Offset

从元素的左上角单击具有相对位置(x, y)的给定元素。

 

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
offsetX	int	Required	x相对于元素的位置
offsetY	int	Required	y相对于元素的位置
flowControl	FailureHandling	Optional	指定failure handlingschema以确定是否应该允许执行继续或停止。

 Double Click

双击给定的元素。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
flowControl	FailureHandling	Optional	指定failure handlingschema以确定是否应该允许执行继续或停止。

 Drag And Drop By Offset

拖动对象并将其拖放到偏移位置。

Param	Param Type	Mandatory	Description
sourceObject	TestObject	Required	源对象。
xOffset	int	Required	x 偏移
yOffset	int	Required	y 偏移
flowControl	FailureHandling	Optional	指定failure handlingschema以确定是否应该允许执行继续或停止.

 Drag And Drop To Object

拖动一个对象并将其放到另一个对象上。

Param	Param Type	Mandatory	Description
sourceObject	TestObject	Required	源对象。
destinationObject	TestObject	Required	目标对象。
flowControl	FailureHandling	Optional	指定failure handlingschema以确定是否应该允许执行继续或停止。

Focus

将焦点移动到指定的元素;例如输入字段，将光标移动到该字段。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 Get All Links On Current Page

获取当前页面上的所有链接。

Param	Param Type	Mandatory	Description
isIncludedExternalLinks	boolean	Required	如果为假，只针对同一主机上的链接。否则，指向所有链接。
excludedLinks	List	Required	排除链接(url)的列表。
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 Get Attribute

获取web元素的属性。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素
attribute	String	Required	属性名称
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 返回

Param Type	Description
String	对象属性的值

 Get CSS Value

获取web元素的CSS值。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 返回

Param Type	Description
String	web元素的CSS值

 Get Element Height

获取web元素的高度。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 返回

Param Type	Description
int	web元素的高度。

 Get Element Left Position

获取web元素的左侧位置。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 返回

Param Type	Description
int	web元素的左位置。

 Get Element Width

获取web元素的宽度。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 返回

Param Type	Description
int	web元素的宽度。

 Mouse Over

模拟用户将鼠标悬停在给定的元素上。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 Mouse Over Offset

模拟用户将鼠标悬停在给定元素的左上角相对位置(x, y)上。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
offsetX	int	Required	x相对于元素的位置。
offsetY	int	Required	y相对于元素的位置。
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 Right Click

右键单击给定的元素。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 Right Click Offset

用相对位置(x, y)从元素的左上角右键单击给定的元素

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
offsetX	int	Required	x相对于元素的位置
offsetY	int	Required	y相对于元素的位置
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 Scroll To Element

将元素滚动到浏览器窗口的可见区域

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
timeout	int	Required	系统最多等待超时(秒)返回结果
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 Verify All Links On Current Page Accessible

验证当前页面上的所有链接(url)是否都是可访问的。

Param	Param Type	Mandatory	Description
isIncludedExternalLinks	boolean	Required	如果为假，只针对同一主机上的链接。否则，指向所有链接。
excludedLinks	List	Required	排除链接(url)的列表。
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 Verify Element Attribute Value

验证web元素是否具有具有指定名称和值的属性。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
attributeName	String	Required	要验证的属性的名称。
attributeValue	String	Required	要验证的属性的值。
timeout	int	Required	系统最多等待超时(秒)返回结果
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

返回

• true: 元素具有具有指定名称和值的属性。
• false: 元素没有指定名称和值的属性。

 Verify Element Clickable

验证给定元素是否可单击。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 返回

• true: 元素出现并可单击。

• false: 元素既不存在也不可单击。

 Verify Element Has Attribute

验证web元素是否具有具有指定名称的属性。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
attributeName	String	Required	要验证的属性的名称。
timeout	int	Required	系统最多等待超时(秒)返回结果
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止

 返回

• true: 元素具有具有特定名称的属性。
• false: 元素没有具有特定名称的属性。

 Verify Element Not Clickable

验证给定元素是否不可单击。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止。

 返回

• true: 元素存在且不可单击。

• false: 元素出现并可单击。

 Verify Element Not Has Attribute

验证web元素是否具有具有指定名称的属性。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
attributeName	String	Required	要验证的属性的名称。
timeout	int	Required	系统最多等待超时(秒)返回结果
flowControl	FailureHandling	Optional	指定失败处理模式，以确定应该允许执行还是停止执行

 返回

• true: 元素没有指定名称的属性。
• false: 元素具有具有指定名称的属性

 Verify Element Not Present

验证给定的web元素是否不存在于DOM中。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
timeout	int	Required	系统最多等待超时(秒)返回结果
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止

 返回

true: 元素不存在。 false:元素存在。

 Verify Element Not Visible

验证给定的web元素是否不可见。

Param	Param Type	Mandatory	Description
to	TestObject	Required	表示web元素。
flowControl	FailureHandling	Optional	指定失败处理模式，以确定是否应该允许执行继续或停止

 返回

• true:元素是可见的。
• false: 元素不可见