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
