QMetry Automation Framework provides concept called “Locator Repository” which can be used to abstract your element locator outside the code. Moreover, you can have separate locator repositories per environment/platform and you can configure at runtime to load environment specific locator repository.

Creating Locator repository

You can create Locator repository with property file having extension ‘. property’ or ‘.loc’. In repository provide key-value pair of locator-key and locator-value. While developing test assets insted of providing locator you can use the locator-key. To provide locator-value refer how to locating element.



  login.username.txt = name=uname
  login.password.txt = name=upwd
  login.pageheader.lbl = css=.header
  #self-descriptive locator example
  login.username.txt = {'locator':'name=uname'; 'desc':'User name texbox on Login Page'}
  login.password.txt = {'locator':'name=upwd'; 'desc':'Password texbox on Login Page'}
  login.pageheader.lbl = {'locator':'css=.header'; 'desc':'Header of Login Page'}


you can refer locator-key in your java code for creating a web-element for example:

Java Code:

  QAFWebElement txtUserName = new QAFExtendedWebElement("login.username.txt");

Page Class:

  @FindBy(locator = "login.username.txt")
  private QAFWebElement txtUserName;


While using in-built step you can provide locator-key to refer any locator.

  assert 'login.username.txt' is present
  sendKeys 'myusername' into 'login.username.txt'
Tags: locator java