Adding methods hasElementById(), hasElementByXPath(), hasElementsByXPath() so one can test for elements without having to catch AssertionErrors as per getElementById() etc.

Author: soundasleep

jwebunit-commons-tests/src/main/java/net/sourceforge/jwebunit/tests/IElementTest.java

@@ -18,22 +18,8 @@
  */
 package net.sourceforge.jwebunit.tests;
 
-import static net.sourceforge.jwebunit.junit.JWebUnit.assertCommentNotPresent;
-import static net.sourceforge.jwebunit.junit.JWebUnit.assertCommentPresent;
-import static net.sourceforge.jwebunit.junit.JWebUnit.assertElementPresent;
-import static net.sourceforge.jwebunit.junit.JWebUnit.assertFormElementPresent;
-import static net.sourceforge.jwebunit.junit.JWebUnit.assertMatch;
-import static net.sourceforge.jwebunit.junit.JWebUnit.assertNotMatch;
-import static net.sourceforge.jwebunit.junit.JWebUnit.assertTextFieldEquals;
-import static net.sourceforge.jwebunit.junit.JWebUnit.beginAt;
-import static net.sourceforge.jwebunit.junit.JWebUnit.getElementById;
-import static net.sourceforge.jwebunit.junit.JWebUnit.getElementByXPath;
-import static net.sourceforge.jwebunit.junit.JWebUnit.getElementsByXPath;
-import static net.sourceforge.jwebunit.junit.JWebUnit.setBaseUrl;
-import static net.sourceforge.jwebunit.junit.JWebUnit.setTextField;
-import static org.junit.Assert.assertEquals;
-import static org.junit.Assert.assertNotNull;
-import static org.junit.Assert.fail;
+import static net.sourceforge.jwebunit.junit.JWebUnit.*;
+import static org.junit.Assert.*;
 
 import java.util.Date;
 import java.util.List;
@@ -65,6 +51,21 @@ public void testSimple() {
     	assertEquals(element.getAttribute("id"), "test");
     	assertEquals(element.getAttribute("value"), "test3");
     }
+    
+    @Test
+    public void testSimpleHasID() {
+    	assertTrue(hasElementById("test"));
+    }
+
+    @Test
+    public void testSimpleHasXPath() {
+    	assertTrue(hasElementByXPath("//input[@id='test']"));
+    }
+
+    @Test
+    public void testSimpleHasXPaths() {
+    	assertTrue(hasElementsByXPath("//input[@id='test']"));
+    }
 
     @Test
     public void testMissing() {
@@ -77,6 +78,21 @@ public void testMissing() {
     	}
     }
 
+    @Test
+    public void testMissingHasID() {
+    	assertFalse(hasElementById("test2"));
+    }    
+    
+    @Test
+    public void testMissingHasXPath() {
+    	assertFalse(hasElementByXPath("//input[@id='test2']"));
+    }
+    
+    @Test
+    public void testMissingHasXPaths() {
+    	assertFalse(hasElementsByXPath("//input[@id='test2']"));
+    }
+
     /**
      * Test parent, child methods
      */

jwebunit-core/src/main/java/net/sourceforge/jwebunit/junit/WebTester.java

@@ -2737,6 +2737,16 @@ public IElement getElementByXPath(String xpath) {
       return getTestingEngine().getElementByXPath(xpath);
     }
 
+    /**
+     * Return {@code true} if the given element by XPath exists.
+     *
+     * @param xpath XPath to search
+     * @return {@code true} if the the requested element
+     * @throws AssertionError if the element xpath is not found
+     */
+    public boolean hasElementByXPath(String xpath) {
+      return getTestingEngine().getElementByXPath(xpath) != null;
+    }
 
     /**
      * Get an element for a particular ID.
@@ -2749,6 +2759,16 @@ public IElement getElementById(String id) {
       assertElementPresent(id);
       return getTestingEngine().getElementByID(id);
     }
+    
+    /**
+     * Returns {@code true} if an element with the given ID exists.
+     * 
+     * @param id element ID to find
+     * @return {@code true} if the element ID exists, {@code false} otherwise
+     */
+    public boolean hasElementById(String id) {
+    	return getTestingEngine().getElementByID(id) != null;
+    }
 
     /**
      * Get elements for a particular xpath.
@@ -2760,6 +2780,17 @@ public List<IElement> getElementsByXPath(String xpath) {
       return getTestingEngine().getElementsByXPath(xpath);
     }
 
+    /**
+     * Return {@code true} if the given elements by XPath exists.
+     *
+     * @param xpath XPath to search
+     * @return {@code true} if the given elements by XPath exist
+     */
+    public boolean hasElementsByXPath(String xpath) {
+    	List<IElement> list = getTestingEngine().getElementsByXPath(xpath);
+    	return list != null && !list.isEmpty();
+    }
+
     // label methods
     /**
      * Assert a label for a given ID exists.