firstOnly property

Class: VisualLocatorSettingsPlatform: ProtractorLanguage: JavaScript SDK:

To return only one graphic instance defined by each locator, add this field to the settings passed, with a value of true . To return only all the graphic instance defined by each locator, add this field to the settings passed, with a value of false .

Syntax

let names_A = ["locator_1a", "locator_1b", "locator_1c"];
let locRegions5 = await eyes.locate({
  settings: { locatorNames: names_A, firstOnly: true },
});

Type:boolean

Example

//return a zero or one locator for each of the three locators defined as parameters to name()
let locRegions8 = await eyes.locate( {settings : {locatorNames:["locator_a","locator_b","locator_b"],firstOnly:true}});
  
//return all the locator found for the locators defined in the lists passed to names() or Strings passed to name()                   
let locRegions9 = await eyes.locate( {settings : {locatorNames:["locator_a","locator_b","locator_b"],firstOnly:false}});
//loop through all the locators and click on the center of their region
for (let locator in locRegions9) {
    let regionArray = locRegions9[locator];
    for (let region in regionArray) {
        click(region.x + region.width/2, region.y + region.height/2);
    }
};