转自:https://www.cnblogs.com/du-hong/p/11818693.html
1.-测试结果
1.1-成功,失败和断言
测试被认为是成功的,如果它不引发任何异常完成,还是它扔的预期异常(请参阅文档expectedExceptions属性上找到的@Test注释)。
您的测试方法通常由可能引发异常的调用或各种断言(使用Java“ assert”关键字)组成。“断言”失败将触发AssertionErrorException,这反过来会将方法标记为失败(如果未看到断言错误,请记住在JVM上使用-ea)。
这是一个示例测试方法:
/**
* @author 北京-宏哥
*
* Java自动化测试框架-10 - TestNG之 测试结果篇
*
* 2019年11月9日
*/
@Test
public void verifyLastName() {
assert "Beust".equals(m_lastName) : "Expected name Beust, for" + m_lastName;
}
TestNG还包括JUnit的Assert类,该类使您可以对复杂对象执行断言:
/**
* @author 北京-宏哥
*
* Java自动化测试框架-10 - TestNG之 测试结果篇
*
* 2019年11月9日
*/
import static org.testng.AssertJUnit.*;
//...
@Test
public void verify() {
assertEquals("Beust", m_lastName);
}
请注意,上面的代码使用静态导入,以便能够使用 assertEquals方法而不必在其类之前添加前缀。
1.2-日志和结果
测试运行的结果在启动SuiteRunner时指定的目录中的index.html文件中创建。该文件指向包含整个测试运行结果的各种其他HTML和文本文件。
使用TestNG与监听器和报告器生成自己的报告非常容易:
侦听器实现org.testng.ITestListener接口,并在测试开始,通过,失败等时实时通知。
报告程序实现org.testng.IReporter接口,并在TestNG已运行所有套件时收到通知。IReporter实例接收描述整个测试运行的对象列表。
例如,如果要生成测试运行的PDF报告,则无需实时通知测试运行,因此您应该使用IReporter。如果您想编写测试的实时报告,例如带有进度条的GUI或在每次测试被调用时显示点(“。”)的文本报告程序(如下所述),则ITestListener是您的最好的选择。
1.2.1-日志侦听器
这是一个显示“。”的侦听器。对于每个通过的测试,对于每个失败,都为“ F”,对于每个跳过均为“ S”:
/**
* @author 北京-宏哥
*
* Java自动化测试框架-10 - TestNG之 测试结果篇
*
* 2019年11月9日
*/
public class DotTestListener extends TestListenerAdapter {
private int m_count = 0;
@Override
public void onTestFailure(ITestResult tr) {
log("F");
}
@Override
public void onTestSkipped(ITestResult tr) {
log("S");
}
@Override
public void onTestSuccess(ITestResult tr) {
log(".");
}
private void log(String string) {
System.out.print(string);
if (++m_count % 40 == 0) {
System.out.println("");
}
}
}
在此示例中,我选择扩展TestListenerAdapter,该方法使用空方法实现ITestListener,因此我不必从我不感兴趣的接口中覆盖其他方法。您可以根据需要直接实现该接口。
这是我调用TestNG来使用此新侦听器的方法:
java -classpath testng.jar;%CLASSPATH% org.testng.TestNG -listener org.testng.reporters.DotTestListener test\testng.xml
和输出:
........................................
........................................
........................................
........................................
........................................
.........................
===============================================
TestNG JDK 1.5
Total tests run: 226, Failures: 0, Skips: 0
===============================================
请注意,当您使用-listener时,TestNG将自动确定您要使用的侦听器的类型。
1.2.2-日志记者
该org.testng.IReporter接口只有一个方法:
public void generateReport(List<ISuite> suites, String outputDirectory)
当所有套件都已运行时,TestNG将调用此方法,您可以检查其参数以访问刚刚完成的运行中的所有信息。
1.2.3-JUnitReports
TestNG包含一个侦听器,该侦听器获取TestNG结果并输出一个XML文件,然后可以将其馈送到JUnitReport。 这是一个示例,以及创建此报告的ant任务:
<target name="reports">
<junitreport todir="test-report">
<fileset dir="test-output">
<include name="*/*.xml"/>
</fileset>
<report format="noframes" todir="test-report"/>
</junitreport>
</target>
注意:JDK 1.5和JUnitReports当前不兼容,无法使用框架版本,因此您需要指定“ noframes”才能使其正常工作。
1.2.4-Reporter API
如果需要日志应在生成的HTML报告中显示的消息,则可以使用org.testng.Reporter类:
Reporter.log (“已呼叫M3” );
1.2.5-XML报告
TestNG提供了一个XML报告程序,用于捕获JUnit报告中不提供的TestNG特定信息。当用户的测试环境需要使用JUnit格式无法提供的具有TestNG特定数据的XML结果时,此功能特别有用。记者可以通过使用命令行注入TestNG的-reporter。
这是一个示例用法:-reporter org.testng.reporters.XMLReporter:generateTestResultAttributes = true,generateGroupsAttribute = true。
下表详细介绍了可以传递的所有选项。确保使用:
: -将报告者名称与其属性分开
= -分隔属性的键/值对
, -分隔多个键/值对
以下是此类报告器的输出示例:
<testng-results>
<suite name="Suite1">
<groups>
<group name="group1">
<method signature="com.test.TestOne.test2()" name="test2" class="com.test.TestOne"/>
<method signature="com.test.TestOne.test1()" name="test1" class="com.test.TestOne"/>
</group>
<group name="group2">
<method signature="com.test.TestOne.test2()" name="test2" class="com.test.TestOne"/>
</group>
</groups>
<test name="test1">
<class name="com.test.TestOne">
<test-method status="FAIL" signature="test1()" name="test1" duration-ms="0"
started-at="2007-05-28T12:14:37Z" description="someDescription2"
finished-at="2007-05-28T12:14:37Z">
<exception class="java.lang.AssertionError">
<short-stacktrace>
<![CDATA[
java.lang.AssertionError
... Removed 22 stack frames
]]>
</short-stacktrace>
</exception>
</test-method>
<test-method status="PASS" signature="test2()" name="test2" duration-ms="0"
started-at="2007-05-28T12:14:37Z" description="someDescription1"
finished-at="2007-05-28T12:14:37Z">
</test-method>
<test-method status="PASS" signature="setUp()" name="setUp" is-config="true" duration-ms="15"
started-at="2007-05-28T12:14:37Z" finished-at="2007-05-28T12:14:37Z">
</test-method>
</class>
</test>
</suite>
</testng-results>
该报告程序与其他默认侦听器一起注入,因此默认情况下您可以获得这种类型的输出。侦听器提供了一些属性,可以对报告器进行调整以满足您的需求。下表包含这些属性的列表,并附有简短说明:
Property | Comment | Default value |
---|---|---|
outputDirectory | A String indicating the directory where should the XML files be output. | The TestNG output directory |
timestampFormat | Specifies the format of date fields that are generated by this reporter | yyyy-MM-dd'T'HH:mm:ss'Z' |
fileFragmentationLevel | An integer having the values 1, 2 or 3, indicating the way that the XML files are generated: |
1 |
splitClassAndPackageNames | This boolean specifies the way that class names are generated for the <class> element. For example, you will get <class class="com.test.MyTest"> for false and <class class="MyTest" package="com.test"> for true. | false |
generateGroupsAttribute | A boolean indicating if a groups attribute should be generated for the <test-method> element. This feature aims at providing a straight-forward method of retrieving the groups that include a test method without having to surf through the <group> elements. | false |
generateTestResultAttributes | A boolean indicating if an <attributes> tag should be generated for each <test-method> element, containing the test result attributes (See ITestResult.setAttribute() about setting test result attributes). Each attribute toString() representation will be written in a <attribute name="[attribute name]"> tag. | false |
stackTraceOutputMethod | Specifies the type of stack trace that is to be generated for exceptions and has the following values: |
2 |
generateDependsOnMethods | Use this attribute to enable/disable the generation of a depends-on-methods attribute for the <test-method> element. | true |
generateDependsOnGroups | Enable/disable the generation of a depends-on-groups attribute for the <test-method> element. | true |
为了配置此报告程序,可以在命令行中使用-reporter选项,也可以将Ant 任务与嵌套的<reporter>元素一起使用。对于其中的每个,您都必须指定org.testng.reporters.XMLReporter类。请注意,您无法配置内置报告器,因为该报告器仅使用默认设置。如果只需要
带有自定义设置的XML报告,则必须使用两种方法之一手动添加它并禁用默认侦听器。
1.2.6-TestNG退出代码
当TestNG完成执行时,它将退出并返回代码。
可以检查此返回码以了解故障的性质(如果有的话)。
下表总结了TestNG当前使用的不同退出代码。
FailedWithinSuccess | Skipped | Failed | Status Code | Remarks |
---|---|---|---|---|
No | No | No | 0 | Passed tests |
No | No | Yes | 1 | Failed tests |
No | Yes | No | 2 | Skipped tests |
No | Yes | Yes | 3 | Skipped/Failed tests |
Yes | No | No | 4 | FailedWithinSuccess tests |
Yes | No | Yes | 5 | FailedWithinSuccess/Failed tests |
Yes | Yes | No | 6 | FailedWithinSuccess/Skipped tests |
Yes | Yes | Yes | 7 | FailedWithinSuccess/Skipped/Failed tests |
2.-小结
好了,今天关于TestNG之测试结果,就分享到这里。
来源:oschina
链接:https://my.oschina.net/u/4297414/blog/4271851