抛出异常
动词：failTest
可从以下位置获取: <Enterprise>
在脚本中抛出异常，并在 IBM RPA Studio的测试查看器中返回有关该异常的消息。
语法
failTest --message(String)
输入
| 脚本 | 设计器 | 必需的 | AcceptedTypes | 描述 |
|---|---|---|---|---|
| --message | 消息 | 必需的 | 文本 | 抛出异常时记录的消息。IBM RPA Studio 环境变量 "errorMessage" 将输入在 Message 中输入的值。 |
示例
示例 1：由于访问的 Web 站点是英语的，因此使用此命令会引发异常。 错误消息为：“This script cannot be executed, the page is in Portuguese.”
defVar --name siteEN --type String --value "https://www.ibm.com"
webStart --name web01 --type "Chrome"
webNavigate --url "${siteEN}"
if --left "${siteEN}" --operator "Contains" --right "lang=en" --negate
failTest --message "This script cannot be executed, the page is in Portuguese."
else
messageBox --title "Welcome!" --text "Welcome to the IBM Robotic Process Automation website!\r\n" --icon "Information" --buttons "OK" --defaultbutton "FirstButton"
endIf
webClose --name web01 --leavebrowseropen
示例 2：与上一个示例类似，不同之处在于此次使用的是英语页面，因此演示了脚本执行成功的场景。
defVar --name siteEN --type String --value "https://www.ibm.com"
webStart --name web01 --type "Chrome"
webNavigate --url "${siteEN}"
if --left "${siteEN}" --operator "Contains" --right "lang=en" --negate
failTest --message "This script cannot be executed, the page is in Portuguese."
else
messageBox --title "Welcome!" --text "Welcome to the IBM Robotic Process Automation website!\r\n" --icon "Information" --buttons "OK" --defaultbutton "FirstButton"
endIf
webClose --name web01 --leavebrowseropen
异常方案的验证通过 IBM RPA Studio的测试查看器进行可视化。 对于提供的两个示例，验证操作均返回“失败”。
备注
如果异常位于 IBM RPA Studio 测试上下文外部，那么 抛出异常 命令将无法有效捕获异常。 因此，不会在流程自动化期间使用此命令。
IBM RPA Studio Test Viewer 在顶部菜单中的路径下提供: 视图> 测试资源管理器。
抛出异常引发的异常可以通过处理错误命令进行捕获。