This tutorial will explore how to design and automate a test case using Google Search as an example. Particularly, we’ll see an example of functional black-box testing. First, functional testing is a type of software testing in which test cases derive from the specifications of the software under test. In other words, functions are tested by providing input and examining the output against specified or implicit functional requirements. Black-box testing examines the functionality of an application without peering into its internal structure. So, functional black-box testing aims to verify if an application respects its functionalities specifications (i.e. it does what it is supposed to do) by ignoring its specific internal structure. Test automation means using a software tool to control the execution of the tests and the comparison of the outcomes with the expected ones. In this tutorial, you will use the Maveryx testing tool and its Java API to automate tests using Google Search. Maveryx is automated functional testing and regression testing tool. It provides automated testing capabilities for functional, regression, UI, data-driven, codeless, and low-code testing of desktop and web applications. Writing test scripts is one of the main activities in test automation. A test script is a sequence of instructions to execute a test. To put it another way, it is a short program written in a scripting or programming language, like Java.

1. © 2021 Maveryx srl.
All rights reserved.
How to easily design
and
automate a test case

2. © 2021 Maveryx srl.
All rights reserved.
Summary
• Functional black box testing
• Functional test design & implementation (automation)
• The Google Search example
• Conclusion

3. © 2021 Maveryx srl.
All rights reserved.
Functional Testing
• Functional testing verifies that all functionality of the
application under test operate in conformance with their stated
and implicit specification
• Functional testing checks whether the application under test "do what
is supposed to do“
• (“Alternatively”) Functional testing is the process of attempting
to find discrepancies between the application and its
specification

4. © 2021 Maveryx srl.
All rights reserved.
Black-box Testing
• Black-box testing examines the functionality of an application
without peering into its internal structure.
• Completely unconcerned about the internal structure and behavior of
the application being tested.

5. © 2021 Maveryx srl.
All rights reserved.
Functional Black-box Testing
• Functional black-box testing is a
process of attempting to show
that an application matches its
functional specifications, by
ignoring its internal structure.
• Functionality are tested by
providing them inputs and
examining the outputs against the
functional requirements
• The implementation is not known

6. © 2021 Maveryx srl.
All rights reserved.
What is a test automation?
• In software testing, test automation is the use of a software (called
test automation tool) separated from the software being tested, to
control the execution of tests and the comparison of actual
outcomes with predicted outcomes.

7. © 2021 Maveryx srl.
All rights reserved.
What is a test automation?
• Test Automation is a type of testing in which a software tool
executes without human intervention a set of test scripts by:
• performing test actions against the application under test
• comparing the actual results to the expected behavior
• creating test reports

8. © 2021 Maveryx srl.
All rights reserved.
Benefits of test automation
• Test automation is used to repeat more and more times tasks that
are laborious and time-consuming to do manually
• Automated tests can be run quickly and repeatedly and are more
reliable than manual testing approaches
• Numerous open-source and commercial testing tools exist for all
types of testing (functional, UI, performance, security...) and for all
kinds of applications like desktop, web, and mobile

9. © 2021 Maveryx srl.
All rights reserved.
The Demo Application: Google Search
• For the purposes of this tutorial Google Search is used.

10. © 2021 Maveryx srl.
All rights reserved.
Design Test Case
• Use Case
1. Go to google.com (Google Search page)
2. Type "Maveryx" into the search box
3. Click 'Google Search' button to view results
4. Click on the first result (Maveryx website)

11. © 2021 Maveryx srl.
All rights reserved.
Design Test Case
TEST ACTION EXPECTED OUTCOME
Launch browser and navigate to Google
page at https://www.google.com/
Google search page is displayed
Type "Maveryx" into the search box "Maveryx" is typed into the search box
Click 'Google Search' button to start
searching
Search results are displayed
Click on the first result Maveryx homepage is displayed
This test can be executed manually, or it can be automated

12. © 2021 Maveryx srl.
All rights reserved.
Design Test Script
1. Launch Chrome browser
2. Navigate to URL https://www.google.com/en
3. Assert that the Google search page is displayed
4. Type "Maveryx" into the search box
5. Assert that the string "Maveryx" is typed into the
search box
6. Click the 'Google Search' button
7. Check that the search results are displayed
8. Click on the first result (Maveryx homepage)
9. Check that the Maveryx homepage is displayed

13. © 2021 Maveryx srl.
All rights reserved.
Launch browser and Navigate to the website
To open the Google Search in Chrome browser, create an XML “launch” file like:
In the Java test script add the following lines:
//the Chrome->Google Search launch file path
final String chromeGoogleSearch = System.getProperty("user.dir")+"dataGoogle.xml";
//launch Chrome browser and navigate to Google Search
Bootstrap.startApplication(chromeGoogleSearch);
<?xml version="1.0" encoding="UTF-8"?>
<AUT_DATA>
<EXECUTABLE_PATH></EXECUTABLE_PATH>
<APPLICATION_NAME>CHROME</APPLICATION_NAME>
<TOOLKIT>WEB</TOOLKIT>
<AUT_ARGUMENTS>https://www.google.com/en</AUT_ARGUMENTS>
</AUT_DATA>

14. © 2021 Maveryx srl.
All rights reserved.
Working with the HTML elements
• To work with the web elements such as buttons, texts, etc.
1. Locate the HTML elements to test
2. Perform the test action
• To locate the HTML element to test, Maveryx does NOT use neither
"GUI Maps" nor "Locators".
With Maveryx you can locate the HTML element to test specifying
• identifier (e.g. name, id, title, caption, …)
• type (e.g. button, text, drop-down list, label, …)

15. © 2021 Maveryx srl.
All rights reserved.
Locate the HTML elements
The search text box can be identified by its title = "Search"
The search button can be identified by its caption "Google Search"
identifier
type
type identifier
//the 'Search' text box
GuiText searchBox = new GuiText("Search");
//'Google Search' button
GuiButton search = new GuiButton("Google Search");

16. © 2021 Maveryx srl.
All rights reserved.
Perform test actions
Once located the HTML element you can perform the relevant test action.
In this test:
• enter text into the search box
• click the ‘Google Search’ button
• click an hyperlink (the first search result)
//the Search text box
GuiText searchBox = new GuiText("Search");
searchBox.setText(searchKey);//type the search term
//the 'Google Search' button
GuiButton search = new GuiButton("Google Search");
search.click(); //click the 'Google Search' button
//the first item of the search result page
GuiHyperlink result = new GuiHyperlink("Maveryx-Test Automation Tool for GUI Testing");
result.click(); //click it

17. © 2021 Maveryx srl.
All rights reserved.
Check the Results: Assertions
• To compare expected outcomes and the actual outcomes,
assertions can be added to the test script
• expected results = actual results  the test case is PASSED
• expected results ≠ actual results  the test case is FAILED
//check that the string "Maveryx" is inserted into the search box
assertEquals(searchKey, searchBox.getText());
String expectedURL = "https://www.maveryx.com/";
assertEquals(expectedURL, new GuiBrowser().getCurrentPageUrl());//check the
(landing) page url

18. © 2021 Maveryx srl.
All rights reserved.
Check the Results: WaitForObject
• Checking if a test object is present or not in the web page
• The waitForObject function waits until the given object exists.
• Returns if successful (the test object is present)
• Raises an ObjectNotFoundException on failure, if the function times out and the
test object is not present
//the Search text box
GuiText searchBox = new GuiText("Search");
//check that the search textbox is present
searchBox.waitForObject(3, 1);
//check whether the landing page is the Maveryx website
new GuiHtmlElement("Trailblazing Functional Automated UI
Testing").waitForObject(3, 1);//the main message is displayed

19. © 2021 Maveryx srl.
All rights reserved.
Conclusion
• Functional black-box testing is the process of attempting to show that
an application matches its specifications, ignoring its implementation
• Start designing the test case than automate it. Remember that to each
test action shall correspond an expected response.
• Automated test scripts in case of web pages or web applications
includes
• identifying web elements
• acting on web elements
• asserting on expected outputs vs. actual outcomes