03/08/2013 Written by Cyril GRANDJEAN

When you are developing a release of a web application, you will very often need to create a testing procedure which will test all the features of your application. Then, you will have to run all the tests manually for each version of your software in order to ensure that no regression has occurred. Functional manual tests are long, boring and can be subject to some human errors.

You can avoid these disadvantages by automating your functional tests using Selenium library. By using Selenium library in Java, you will be able to automate your web browser actions and you will be able to check that these actions will make their expecting behaviour.

We will take example of this basic PHP program:

<?php
session_start();

//We add the element into an array in session
if(isset($_POST['elementToAdd']))
{
	//If the array is already created
	if(is_array($_SESSION['array']))
	{
		//Limit of 10 elements
		if(sizeof($_SESSION['array']) < 10)
		{
			//We add our element
			array_push($_SESSION['array'],$_POST['elementToAdd']);
		}
	}
	else
	{
		//We create a new array
		$_SESSION['array'] = array($_POST['elementToAdd']);
	}
}
//We remove an element from the array in session
else if(isset($_POST['elementToDelete']))
{
	unset($_SESSION['array'][array_search($_POST['elementToDelete'], $_SESSION['array'])]);
}
?>
<html>
<head>
</head>
<body>
	<?php
	//We display the HTML array if there is any element in session
	if(isset($_SESSION['array']) && is_array($_SESSION['array']) && sizeof($_SESSION['array']) > 0)
	{
	?>
		<table>
			<?php
			//We display our elements in session
			foreach ($_SESSION['array'] as $value)
			{
			?>
				<tr class="aRow">
					<td class="rowValue">
						<?php echo $value ?>
					</td>
					<td>
						<form method="post">
							<input type="hidden" name="elementToDelete" value="<?php echo $value ?>" />
							<input type="submit" class="deleteButton" value="Delete element" />
						</form>
					</td>
				</tr>
			<?php
			}
			?>
		</table>
	<?php
	}	
	?>
	
	<form method="post">
		<input name="elementToAdd" type="text" />
		<input id="submitButton" type="submit" value="Add element" />
	</form>
</body>
</html>

You can click here to find the result of this PHP script.

Inside this PHP script, we have a form which we will use in order to add an element into a table stored in session limited to 10 elements only. When an element is added into the array, we can remove it by pressing the remove button.

We will create the following functional tests which we will automate using Selenium:

  • We create an element into the array and check that the element is well added.
  • We remove the element from the array and check that the element is well removed.
  • We test the limit of 10 elements.
public class SeleniumClass {

    /**
     * Driver of the web browser
     */
    private WebDriver driver;

    /**
     * Code to execute before any JUnit test
     */
    @Before
    public void setUp() {

        //We instantiate a Firefox driver
        driver = new FirefoxDriver();

        //We set a maximum timeout of 5 seconds
        driver.manage().timeouts().implicitlyWait(5, TimeUnit.SECONDS);
    }

    /**
     * JUnit test for our functional tests
     */
    @Test
    public void testElementPage()
    {
        //We load the page
        driver.get("http://www.cyril-grandjean.co.uk/en/selenium.php");

        //We fill the text field with the name elementToAdd with the value element to add
        driver.findElement(By.name("elementToAdd")).sendKeys("element to add");

        //We click on the button with the id submitButton
        driver.findElement(By.id("submitButton")).click();

        //We check that 1 element with the class name rowValue has been added
        assert driver.findElements(By.className("rowValue")).size() == 1;

        //We check the value of the element in the HTML array
        assert driver.findElement(By.className("rowValue")).getText().equals("element to add");

        //We check the hidden input of the form to delete the element by checking the value attribute
        assert driver.findElement(By.name("elementToDelete")).getAttribute("value").equals("element to add");

        //We remove the element by clicking on the delete button
        driver.findElement(By.className("deleteButton")).click();

        //We check that the element has been removed
        assert driver.findElements(By.className("rowValue")).size() == 0;

        //We will try to add 11 elements
        for(int counterElementAdded = 0; counterElementAdded < 11; counterElementAdded++)
        {
            //We fill the text field with the name elementToAdd with the value element to add
            driver.findElement(By.name("elementToAdd")).sendKeys("element to add");

            //We click on the button with the id submitButton
            driver.findElement(By.id("submitButton")).click();
        }

        //We check that there is still 10 elements
        assert driver.findElements(By.className("rowValue")).size() == 10;

        //We remove the elements by clicking on the delete buttons
        while (driver.findElements(By.className("deleteButton")).size() > 0)
        {
            //We remove the element by clicking on the delete button
            driver.findElements(By.className("deleteButton")).get(0).click();
        }

        //We check that the elements have been removed
        assert driver.findElements(By.className("rowValue")).size() == 0;
    }

    /**
     * Code to execute after each JUnit test
     */
    @After
    public void tearDown() {

        //We quit the driver
        driver.quit();
    }
}

With this JUnit Selenium test, we have been able to automatically tests all the features of our PHP script.

You can find more information about Selenium at this link : http://docs.seleniumhq.org