【转】 HtmlUnit简介

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的使用，也有着基本的套路，如下：

 

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文档。

 

超链接

// 或取一个<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这个对象，以及表单操作的相应方法：

 

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代码来测试：

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测试代码，则可以作为自动化测试，不过不知道有没有公司这么干的。