Common tips for using Xpath in Katalon Studio
About the author
Marek Melocik is currently working as Test Automation Engineer in Brno, Czech Republic. He has been working in the QA industry since 2014.
Meet Marek at www.linkedin.com/in/marek-melocik
What is XPath?
First of all, let's define what XPath is. XPath is one of HTML selectors which are used in test automation. Basically, it is a path from the top tag (body) of HTML page (absolute XPath) or a path derived from some web element (relative XPath). Except for XPath, you can use also other selector types such as CSS selector.
I created a very simple web page for this tutorial's purposes. I will refer to this code in the whole tutorial. This is a source code:
<html> <head> <title>My First Page</title> </head> <body> <div id="header" class="hdr-main"> <div id="logo"> <img src="https://github.com/katalon-studio/docs-images/raw/master/whatever.png" alt="My logo"> </div> <div id="main" class="body-main"> <h1>Main header</h1> <div id="text"> <p>Sample text.</p> <div id="main-button"> <button type="button" onclick="alert('Button was clicked!')">Click me</button> </div> </div> <div id="mainSelectBox"> <select> <option value="opt1" selected>Option 1</option> <option value="opt2">Option 2</option> <option value="opt3">Option 3</option> </select> </div> <div id="mainInput"> <input id="myInputId" type="text" placeholder="Sample input"> </div> </div> <div id="footer" class="footer-main"> <small>All rights reserved.</small> </div> </body> </html>
- nodename Selects all nodes with the name "nodename"
- / Selects from the root node
- // Selects nodes in the document from the current node that matches the selection no matter where they are
- . Selects the current node
- .. Selects the parent of the current node
- @ Selects attributes
- [ ] Node predicates
- | Computes two node-sets //book | //cd
- + Addition 6 + 4
- – Subtraction 6 – 4
- * Multiplication 6 * 4
- div Division 8 div 4
- = Equal price=9.80
- != Not equal price!=9.80
- < Less than price<9.80
- <= Less than or equal to price<=9.80
Greater than price>9.80
= Greater than or equal to price>=9.80
- or or price=9.80 or price=9.70
- and and price>9.00 and price<9.90
- mod Modulus (division remainder) 5 mod 2
XPath Best practices
1. The very best and ultimate practice is to avoid using absolute Xpaths. Use this only and only when there is no other choice. It works, but it is really hard to maintain – even the smallest change in page's source code can make Xpath invalid. Sample absolute Xpath in our sample code: /body/div/div/div/button This example does not look so bad, BUT – in feature-rich websites, you may have 15-20 elements between the root element and your object.
2. If possible, keep your XPaths easy and short. Prefer using direct XPath (when unique identifier is present) Example: **//input[@id="myInputId"] **Attribute id is (should be) unique within a page, so you may be sure that you are about to use correct element.
3. If unique identifier is not present, find nearest ancestor/descendant with unique identifier. Then, use relative Xpath to locate your element. Example: //div[@id="text"]/p Element p does not have any unique ID, but its nearest ancestor (parent element) has. So relative Xpath approach can be easily applied.
4. Use XPath operator and to get element by multiple attributes **//img[@src="https://github.com/katalon-studio/docs-images/raw/master/whatever.png" and @alt="My logo"] **This may be useful when a single attribute may not be sufficient to identify an element, i.e. when the same image is used on multiple places, but alt attribute is different.
5. text() and contains() functions XPath offers several functions, but probably most used for test automation are text() and contains(haystack, needle) methods. Text() returns a text of current node, contains() returns true/false based on parameters.Example: **//small[text()="All rights reserved."] //small[contains(text(), "rights")]**You may see that in the first option, you have to specify exact text, whereas, in the second option, it is enough to provide only a substring. In our case, for contains method, you provide a result of text() method as a haystack and substring as a needle.
6. Get N-th element when there are multiple (and same) siblings. This approach may be useful mostly for searching in tables when you don't have unique identifier for table data elements, but it can be applied to any other element. Example://div[@id="mainSelectBox"]/select/option This expression returns second
How to get and verify XPaths
Browser console allows you to verify your XPath directly. Type $x("//yourxpath") into a console and if the element exists, it is returned in a console. When multiple elements match the expression, an array of these elements is returned.
There are also multiple browser extensions which may help you with getting and evaluating XPaths. You can find them in add-ons store in your favorite browser, I use addon ChroPath (available for Chrome and Firefox), but there are also many others. You can try more of them and choose the one which is the best for you.
XPath is a powerful selector which has many different operators and methods for working with web elements. Think about the best option for specific element, do not rely on browser tools and their pre-generated paths.
And one more advice from me – don't be afraid to tell your teammate, who is responsible for UI development, to add unique identifiers for web elements you use for test automation. It is much easier when you define XPath as //element[id='whatever'] and you don't have to care about long and difficult paths.