theia-element
This package provides more specific implementation than @theia-extension-tester/abstract-element does. Abstract element is meant to be more abstract whereas TheiaElement is supposed to be tailored specifically for Eclipse Theia editors. TheiaElement enhances AbstractElement with new getters which are tied to Theia locator properties.
With TheiaElement are bundled locators as well. Locators are used to make page objects version independent so it is possible to work with multiple Eclipse Theia releases. Locators use Selenium WebDriver locator object but extra metadata are bundled.
Usage
Install via npm
npm install @theia-extension-tester/theia-element
Install via yarn
yarn add @theia-extension-tester/theia-element
TheiaElement is in the most cases used as super class for new page objects but there is one useful use case outside that. It can be used for element searching and utilize recovery algorithms when searching.
Search custom element example:
const element = new TheiaElement(By.id("weather-panel"));Creating locators for new version
To adapt locators to new version, create new file with format which can be seen in ./src/locators/theia/versions.
Versions can be skipped but it is better not to. The new file must export the following code:
export const diff: LocatorDiff = {
...changedLocators
}