
本文介绍如何通过自定义 groovy 工具类与测试监听器(test listener)精确捕获单个测试用例的执行耗时,并将其集成至自定义报告中,避免依赖日志解析,提升报告自动化与可靠性。
本文介绍如何通过自定义 groovy 工具类与测试监听器(test listener)精确捕获单个测试用例的执行耗时,并将其集成至自定义报告中,避免依赖日志解析,提升报告自动化与可靠性。
在 Katalon Studio 中,测试执行完成后日志视图会显示“Elapsed time”,但该时间仅用于界面展示,无法直接编程访问。若需将耗时数据写入自定义 HTML/Excel 报告、发送至监控平台或做性能基线比对,必须通过代码主动测量——推荐采用高精度、线程安全、生命周期可控的计时方案。
✅ 推荐实现:单例计时工具类 + 测试监听器钩子
首先创建一个线程安全的 Groovy 工具类 ElapsedTimeUtil,封装开始计时与获取耗时逻辑:
package com.katalon.utils
import groovy.time.TimeCategory
import groovy.time.TimeDuration
public class ElapsedTimeUtil {
private static final ElapsedTimeUtil _instance = new ElapsedTimeUtil()
private Date startTime
private ElapsedTimeUtil() {}
public static ElapsedTimeUtil getInstance() {
return _instance
}
public void startTimer() {
this.startTime = new Date()
}
public TimeDuration getElapsedTime() {
if (startTime == null) {
return new TimeDuration(0, 0, 0, 0) // 返回 0 秒占位值
}
return TimeCategory.minus(new Date(), startTime)
}
// 可选:返回格式化字符串(如 "00:01:23.456")
public String getFormattedElapsedTime() {
TimeDuration duration = getElapsedTime()
return String.format('%02d:%02d:%02d.%03d',
duration.hours, duration.minutes, duration.seconds, duration.millis)
}
}⚠️ 注意事项:
- 使用
static final单例模式确保同一 JVM 内全局唯一实例,避免多测试用例并发时状态污染;getElapsedTime()内置空值防护,防止未调用startTimer()就获取耗时导致 NPE;TimeDuration支持毫秒级精度,且可直接用于计算或格式化输出。
? 集成到测试生命周期:使用 Test Case Listener
-
创建 Test Listener(菜单:
File > New > Test Listener); - 在
@BeforeTestCase方法中启动计时器:
@BeforeTestCase
def beforeTestCase(TestCaseContext testCaseContext) {
com.katalon.utils.ElapsedTimeUtil.getInstance().startTimer()
}- 在
@AfterTestCase方法中读取耗时,并传入你的报告生成逻辑(例如调用自定义关键字ReportUtil.logExecutionTime(...)):
@AfterTestCase
def afterTestCase(TestCaseContext testCaseContext) {
TimeDuration elapsed = com.katalon.utils.ElapsedTimeUtil.getInstance().getElapsedTime()
String formatted = com.katalon.utils.ElapsedTimeUtil.getInstance().getFormattedElapsedTime()
// 示例:写入全局变量供报告使用
GlobalVariable.reportElapsedTime = formatted
// 或直接调用报告工具类
CustomKeywords.'com.katalon.report.ReportUtil.appendToCustomReport'(
testCaseContext.getTestCaseId(),
"Execution Time",
formatted
)
}? 进阶建议
- 若需统计整个测试套件耗时,可在
@BeforeTestSuite/@AfterTestSuite中复用同一工具类; - 对于失败用例,
@AfterTestCase仍会执行,因此耗时数据完整可靠; - 如需纳秒级精度(如性能压测场景),可改用
System.nanoTime(),但需自行处理单位转换与溢出; - 所有自定义类须置于
Keywords/目录下或正确配置为 Custom Keyword 并导入包路径。
通过该方案,你不再依赖日志文本解析这种脆弱方式,而是以编程方式精准、稳定、可扩展地获取测试耗时,为构建企业级自动化质量看板打下坚实基础。

















