【转】 HtmlUnit简介

article/2025/10/14 22:47:53

HtmlUnit简介：

引自 http://www.javaeye.com/topic/166702

HtmlUnit 是 JUnit 的扩展测试框架之一。HtmlUnit 将返回文档模拟成 HTML，这样您便可以直接处理这些文档了。HtmlUnit 使用例如 table、form 等标识符将测试文档作为 HTML 来处理。它同样需要遵循 JUnit 测试框架结构的 Java™ 测试程序。

我们可以在http://htmlunit.sourceforge.net/上面下载HtmlUnit，最新版本是1.4。

解压后将lib目录下面的jar文件放入工程的classpath就可以使用了。

基本套路

对于一些开源框架的使用，都有一定的基本套路，对于HtmlUnit，由于是对JUnit的扩展，当然，也需要继承自TestCase，并且也可以Override相应的setUp()和tearDown()方法。对于HtmlUnit的使用，也有着基本的套路，如下：

Java代码

public void testHomePage() throws Exception {
// 新建一个WebClient对象，此对象相当于浏览器
final WebClient webClient = new WebClient();
// 构造一个URL,指向需要测试的URL，如http://www.javaeye.com
URL url = new URL("http://www.javaeye.com");
// 通过getPage()方法，返回相应的页面
HtmlPage page = (HtmlPage) webClient.getPage(url);
// System.out.println(page.getTitleText());
assertEquals(
"JavaEye Java编程 Spring框架 AJAX技术 Agile敏捷软件开发 ruby on rails实践 - JavaEye做最棒的软件开发交流社区",
page.getTitleText());
}

public void testHomePage() throws Exception {
// 新建一个WebClient对象，此对象相当于浏览器
final WebClient webClient = new WebClient();
// 构造一个URL,指向需要测试的URL，如http://www.javaeye.com
URL url = new URL("http://www.javaeye.com");
// 通过getPage()方法，返回相应的页面
HtmlPage page = (HtmlPage) webClient.getPage(url);
// System.out.println(page.getTitleText());
assertEquals(
"JavaEye Java编程 Spring框架 AJAX技术 Agile敏捷软件开发 ruby on rails实践 - JavaEye做最棒的软件开发交流社区",
page.getTitleText());
}

WebClient对象提供了一系列涉及到浏览器的方法，比如像

setThrowExceptionOnScriptError(false|true)－是否抛出页面javascript错误

setThrowExceptionOnFailingStatusCode(false|true)－是否抛出response的错误

HtmlPage对应页面，getTitleText()返回页面的title。

执行测试，就会看到我们所喜爱的绿条。

HtmlUnit的页面组件

像上面的HtmlPage，HtmlUnit中定义了许多页面组件对象，像HtmlForm对应Form表单，HtmlImage对应页面中的img标签， HtmlInput对应页面中的input标签，HtmlAnchor对应页面中的超链接，页面中的每一个标签，HtmlUnit都会有相对应的对象，具体的，可以参看随HtmlUnit下载的doc文档。

超链接

Java代码

// 或取一个<a>的超链接
//HtmlAnchor anchor = (HtmlAnchor) page.getAnchorByName("welcome");
page = (HtmlPage) page.getAnchorByName("welcome").click();
String pageContent = page.getWebResponse().getContentAsString();
System.out.println(pageContent);

// 或取一个<a>的超链接
//HtmlAnchor anchor = (HtmlAnchor) page.getAnchorByName("welcome");
page = (HtmlPage) page.getAnchorByName("welcome").click();
String pageContent = page.getWebResponse().getContentAsString();
System.out.println(pageContent);

Form提交

只是简单的测试一个页面的title,当然无法满足需求，对于WEB应用，有着大量的表单，所以HtmlUnit提供了HtmlForm这个对象，以及表单操作的相应方法：

Java代码

public void testHomePage() throws Exception {
final WebClient webClient = new WebClient();
// 获取首页
final HtmlPage page1 = (HtmlPage) webClient.getPage("http://htmlunit.sourceforge.net");
// 根据form的名字获取页面表单，也可以通过索引来获取：page.getForms().get(0)
final HtmlForm form = page1.getFormByName("myform");
final HtmlSubmitInput button
= (HtmlSubmitInput) form.getInputByName("submitbutton");
final HtmlTextInput textField
= (HtmlTextInput) form.getInputByName("userid");
// 设置表单域的值
textField.setValueAttribute("root");
// 提交表单，返回提交表单后跳转的页面
final HtmlPage page2 = (HtmlPage) button.click();
}

public void testHomePage() throws Exception {
final WebClient webClient = new WebClient();
// 获取首页
final HtmlPage page1 = (HtmlPage) webClient.getPage("http://htmlunit.sourceforge.net");
// 根据form的名字获取页面表单，也可以通过索引来获取：page.getForms().get(0)
final HtmlForm form = page1.getFormByName("myform");
final HtmlSubmitInput button 
= (HtmlSubmitInput) form.getInputByName("submitbutton");
final HtmlTextInput textField 
= (HtmlTextInput) form.getInputByName("userid");
// 设置表单域的值
textField.setValueAttribute("root");
// 提交表单，返回提交表单后跳转的页面
final HtmlPage page2 = (HtmlPage) button.click();
}

表单的提交，超链接的跳转，都是通过click()方法，既通过鼠标点击事件触发的。它们都可以返回相应的HtmlPage对象，然后通过HtmlPage 对象的相应方法来测试，其实，HtmlPage对象，就是包装了页面Html的一个对象，可以通过page.getWebResponse(). getContentAsString()直接返回页面的html代码，然后通过HTML代码来测试：

Java代码

String pageContent = page.getWebResponse().getContentAsString();
System.out.println(pageContent);
int indexInt = pageContent.indexOf(WELCOME);
// assert whether Login successful, using user and password
assertTrue(indexInt != -1);

String pageContent = page.getWebResponse().getContentAsString();
System.out.println(pageContent);
int indexInt = pageContent.indexOf(WELCOME);
// assert whether Login successful, using user and password
assertTrue(indexInt != -1);

页面中的javascript

对于页面中的javascript，HtmlUnit并没有太好的测试方法，也只能通过相应的ScriptEngine来处理。

对于HtmlUnit，个人感觉实用性并不太大。当然，如果有专人写HtmlUnit测试代码，则可以作为自动化测试，不过不知道有没有公司这么干的。