README
Robula+
Robula+ is an algorithm to generate robust XPath-based locators, that are likely to work correctly with new releases of a web application. Robula+ reduces the locators' fragility on average by 90% w.r.t. absolute locators and by 63% w.r.t. Selenium IDE locators [1].
Usage
The code mainly contains of the three following Methods:
getRobustXPath(element, document):
Returns an optimized robust XPath locator string, describing a desired element.
| Parameter | Type | Description |
|---|---|---|
| element | Element | The desired element. |
| document | Document | The document to analyse, that contains the desired element. |
getElementByXPath(xPath, document):
Returns the first element in the given document located by the given xPath locator.
| Parameter | Type | Description |
|---|---|---|
| xPath | string | A xPath string, describing the desired element. |
| document | Document | The document to analyse, that contains the desired element. |
uniquelyLocate(xPath, element, document):
Returns true, if the xPath describes only the desired element.
| Parameter | Type | Description |
|---|---|---|
| xPath | string | A xPath string, describing the desired element. |
| element | Element | The desired element. |
| document | Document | The document to analyse, that contains the desired element. |
Example
Get a robust XPath from an absolute XPath:
import { RobulaPlus } from "robula-plus";
let robulaPlus = new RobulaPlus();
let element = robulaPlus.getElementByXPath('/html/body/div/span/a', document);
robulaPlus.getRobustXPath(element, document);
Installation
Note: The License of this code needs some clarification, so until then there will be no public install package available. If you want to use the code, you have to clone and build it manually, as described in the steps below:
- Download a current version of Node.js.
- To clone this repository, type:
git clone https://github.com/cyluxx/robula-plus.git
- Navigate to the directory, and install dependencies:
cd robula-plus
npm install
- To build the code, run:
npm run build
You now should have a lib folder, that you can include in your private JavaScript / TypeScript project.
About
Authors: Maurizio Leotta, Andrea Stocco, Filippo Ricca and Paolo Tonella.
This TypeScript Implementation by: @Cyluxx
For more information on how the algorithm works, please refer to:
[1] Maurizio Leotta, Andrea Stocco, Filippo Ricca, Paolo Tonella. ROBULA+: An Algorithm for Generating Robust XPath Locators for Web Testing. Journal of Software: Evolution and Process (JSEP), Volume 28, Issue 3, pp.177–204.John Wiley & Sons, 2016. https://doi.org/10.1002/smr.1771