Changes have been made to incorporate new By locator features as well as additional wait condition functionality.

For By locators, these include:

• ByAll that can be used in place of a By locator to locate elements that match all of the provided By locators. This is useful when you want to find an element that matches multiple criteria, such as a button that has a specific text.
  • RemoteWebElement element = app.FindElement(new ByAll(By.TagName("button"), ByExtras.Text("Send Message")));
• ByNested that can be used in place of a By locator to locate elements that are nested by a sequence of locators. This is useful when you want to find an element that is nested within other elements, such as a button that is inside a form, inside an ID'd element.
  • RemoteWebElement element = app.FindElement(new ByNested(By.Id("PersonContainer"), By.TagName("form"), By.TagName("button")));

New wait conditions include:

• ElementIsVisible to wait for an element to be visible with a specific locator at the driver
• ElementIsVisibleInElement to wait for an element to be visible with a specific locator within another element
• ElementIsVisibleInElementWrapper to wait for an element to be visible with a specific locator within an element wrapper
• ElementIsVisibleInPage to wait for an element to be visible with a specific locator within a page object
• ElementIsNotVisible to wait for an element to be hidden (not visible) with a specific locator at the driver
• ElementIsNotVisibleInElement to wait for an element to be hidden (not visible) with a specific locator within another element
• ElementIsNotVisibleInElementWrapper to wait for an element to be hidden (not visible) with a specific locator within an element wrapper
• ElementIsNotVisibleInPage to wait for an element to be hidden (not visible) with a specific locator within a page object
• FrameAvailableToSwitchTo to wait for a frame within the driver to be available and then switching the driver context to that frame

All WaitUntil methods within the platform have been updated to incorporate a retry mechanism, as well as supporting wait conditions that return values other than Booleans. These methods have also been update to return the result of the condition also.

PR checklist

• Have Legerity sample tests been added or updated, run locally, and all pass
• Have added or updated support for platform specific element wrappers been reflected in the Page Object Generator
• Have code styling rules been run on all new source file changes
• Have relevant articles in the docs been added or updated for all new source file changes
• Have major breaking changes been made and are documented

Other information