除了内置关键字,用户还可以定义自定义关键字以扩展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) | 将关键字标记为警告 |