Katalon官方教程——如何创建自定义关键字

除了内置关键字，用户还可以定义自定义关键字以扩展Katalon Studio的功能。创建后，自定义关键字可以像其他内置关键字一样用于测试用例。此功能允许用户扩展关键字并在项目中重复使用它们。

创建一个包

通过一个包，您可以将自定义关键字分组到特定类别，从而使关键字更易于搜索和使用。

1.  从主菜单中选择“ 文件”>“新建”>“包”以打开“ 新建关键字包” 对话框。输入包的名称，然后单击“ 确定” 。

2.相应地在Katalon Studio的关键字下创建新包。

创建自定义关键字

1.  从主菜单中选择“ 文件”>“新建”>“关键字”以打开“ 新建关键字” 对话框。输入关键字的名称，然后选择关键字的包。点击确定。

2.  相应地在指定的包下创建新关键字。

3.  在你的类中输入以下代码，通过Java / Groovy定义自定义关键字：

Item	Description
@Keyword	用来表示下面的代码是在定义关键字
keywordName	自定义关键字的名称
parameters	自定义关键字中使用的参数列表

例如：

4.完成后保存关键字文件。

手动视图中的自定义关键字

按照以下步骤在测试用例的手动视图中使用您定义的自定义关键字：

1 。 在“ 手动” 视图中打开测试用例，然后从命令工具栏中添加脚本中的自定义关键字。

2.  添加一个新的测试步骤，其中包含所有已定义的自定义关键字的列表。在此选择您最近创建的关键字。

“脚本”视图中的自定义关键字

按照以下步骤在测试用例的脚本视图中使用您定义的自定义关键字：

• 该级 CustomKeywords允许您访问所有的自定义关键字。在脚本编辑器中输入以下语法：

</span>
 
CustomKeywords.

• 输入点字符后，内容辅助功能将被调用。内容辅助为代码完成提供了上下文相关的建议。因此，测试项目中定义的所有自定义关键字将显示如下：

• 选择最近创建的关键字并根据需要提供所有参数。

以下API文档提供了有关用于处理自定义关键字的函数的详细信息：

Class	Method	Description
Driver Factory	getWebDriver()	获取当前在活动的web driver
Test Object	addProperty(String name, ConditionType condition, String value)	将新属性添加到测试对象
	setProperties(List<TestObjectProperty> properties)	设置测试对象的属性
	getObjectId()	获取对象ID
	findPropertyValue(String name, boolean caseSensitive)	使用名称查找属性的值
Keyword Util	logInfo(String message)	记录消息
	markError(String message)	将关键字标记为错误
	markErrorAndStop(String message)	将关键字标记为错误并停止执行
	markFailed(String message)	将关键字标记为失败并继续执行
	markFailedAndStop(String message)	将关键字标记为失败并停止执行
	markPassed(String message)	将关键字标记为已通过
	markWarning(String message)	将关键字标记为警告