The major advantage of using object repository is the segregation of objects from test cases. If the locator value of one webelement changes, only the object repository needs to be changed rather than making changes in all test cases in which the locator has been used. Maintaining an object repository increases the modularity of framework implementation. In this tutorial, you will learn-
What is an Object Repository?
Types of Object Repositories in Selenium Web Driver
Selenium Web Driver Object repository using Properties file
Selenium WebDriver Object Repository Using XML File
Types of Object Repositories in Selenium Web Driver
Selenium WebDriver does not offer an in-built object repository by default. However, object repositories can be built using the key-value pair approach wherein the key refers to the name given to the object and value refers to the properties used to uniquely identify an object within the web page. The following are the types of object repositories that can be created in Selenium WebDriver.
Object Repository using Properties file Object Repository using XML file
Selenium Web Driver Object repository using Properties file
In this approach, properties file is a text file wherein data is stored on the form of key-value pairs. The below tutorial will address the following topics.
Creating a properties file in eclipse Storing data onto properties file Reading data from properties file Using properties file in test scripts
Step 1) Creating a properties file in eclipse
To start with, the below java project structure needs to be created in eclipse. Project name and package name can be any valid names.
Right-click on the main project folder and Select New-> Other
In the next window, select General -> File and click on ‘Next’ button
Provide a valid file name with the extension ‘.properties’ on the new file resource window and click on ‘Finish’ button
A file named ‘application.properties’ must be displayed on Project Structure
Step 2) Storing data onto properties file
Data is stored in properties file in the form of key-value pairs, with the key being unique across the file. We will try to use the properties file to identify webelements using locator values. Open application.properties file in Eclipse and store the following data
- For this tutorial, the following demo website is being used: http://demo.guru99.com/test/guru99home/. Here is Test scenario:
Click on Mobile Testing link using XPATH Navigate back Enter data onto email textbox using ID Click on the Sign Up button using ID
Step 3) Reading data from properties file
Reading data from properties file can be done using the built-in Properties class provided in java.util package. Initially, an object of Properties class need to be created as below
We need to create an object of FileInputStream class with the path to properties file
Reading data from properties file can be done using load method offered by Properties class in java. The below code demonstrates the usage of load method.
The string ‘mobileTesting’ will contain the XPATH to identify the Mobile Testing link within the webpage.
Step 4) Using properties file in test scripts
Properties file can be used in test scripts by reading data from a properties file and passing the data as a parameter to the findElement method. The below code demonstrates the usage of data read from properties file in test scripts. The below is the complete code used for the above test scenario.
Selenium WebDriver Object Repository Using XML File
XML stands for Extensible Markup Language. An XML File uses Document Object Model(DOM) as the basic structure. XML File format will replicate the HTML format upon which the webpage is constructed. Below is the list of topics that will be covered.
Creating an XML file in eclipse Storing data onto XML file Reading data from XML file Using XML file in test scripts
Step 1) Creating an XML file in eclipse
The below java project structure needs to be created in Eclipse.
Right-click on the project folder, select New -> Other
Select the XML File within the XML folder and click on ‘Next’ button
Enter a valid XML File name and click on ‘Finish’ button
An XML file will be added to the project folder as shown below
Step 2) Storing data onto XML file
Data can be stored in XML file in the form of Document Object Model (DOM). For simplicity sake, we can use the below test scenario as an example.
Click on Mobile Testing link using XPATH Navigate Back to Home page Enter data onto email textbox using ID Click on the Sign Up button using ID
The below is the format of XML File to be used. Store the above XML code in properties.xml
In the design tab you will see
Step 3) Reading data from XML file
- Reading data from XML file can be accomplished using the built-in ‘dom4j’ class in java. Please note that you need to add the below JAR files into the buildpath of your project before proceeding with the code.
jaxen.jar dom4j-1.6.jar
- Below is the code to read data from XML file.
- Initially, we need to create a File object and pass it as a parameter to the ‘read’ method of SAXReader class. Once the XML file data is read successfully, we can access individual nodes of XML document using the ‘selectSingleNode’ method.
Step 4) Using XML file in test scripts
XML file can be used in test scripts by reading data from XML file and passing the data as parameter to the findElement method. The below code demonstrates the usage of data read from XML file in test scripts. The below code demonstrates the use of XML file in selenium WebDriver Download the WebDriver Eclipse Project
Summary:
An object repository is a common storage location for all objects Selenium WebDriver does not offer an in-built object repository by default You can create 2 Types of Object Repository in Selenium
Object Repository using Properties file Object Repository using XML file
The properties file is a text file wherein data is stored on the form of key-value pairs XML File format will replicate the HTML format upon which the webpage is constructed.