Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yandex-qatools/htmlelements
Html Elements is a Java framework providing easy-to-use way of interaction with web-page elements in web-page tests.
https://github.com/yandex-qatools/htmlelements
framework htmlelements java selenium selenium-webdriver webdriver
Last synced: about 3 hours ago
JSON representation
Html Elements is a Java framework providing easy-to-use way of interaction with web-page elements in web-page tests.
- Host: GitHub
- URL: https://github.com/yandex-qatools/htmlelements
- Owner: yandex-qatools
- License: other
- Created: 2012-09-26T09:56:23.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2024-01-15T10:58:18.000Z (8 months ago)
- Last Synced: 2024-09-20T00:34:33.662Z (5 days ago)
- Topics: framework, htmlelements, java, selenium, selenium-webdriver, webdriver
- Language: Java
- Homepage:
- Size: 820 KB
- Stars: 271
- Watchers: 58
- Forks: 116
- Open Issues: 29
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Html Elements framework
=======================
[](https://github.com/yandex-qatools/htmlelements/releases/latest) [](https://maven-badges.herokuapp.com/maven-central/ru.yandex.qatools.htmlelements/htmlelements-java)
This framework is designed to provide an easy-to-use way of interacting with web-page elements in your tests.
It can be considered to be an extension of WebDriver Page Object.
With the help of the Html Elements framework you can group web-page elements into blocks, encapsulate logic of interaction within them
and then easily use created blocks in page objects. It also provides a set of helpful matchers to use with web-page elements
and blocks. See [JavaDocs](https://oss.sonatype.org/service/local/repositories/releases/archive/ru/yandex/qatools/htmlelements/htmlelements-java/1.16/htmlelements-java-1.16-javadoc.jar/!/index.html)
and [Samples](https://github.com/yandex-qatools/htmlelements-examples) for more details.
You can ask your questions on StackOverflow with the [](http://stackoverflow.com/questions/tagged/htmlelements) tag.
Other Languages
-------------
In case you are not a Java guy/gal, don't panic, there are still few options:
* [Html Elements .NET implementation](https://github.com/yandex-qatools/htmlelements-dotnet) - .NET port made by [Vadzim Hushchanskou](https://github.com/HardNorth)
* [Html Elements PHP implementation](https://github.com/qa-tools/qa-tools) - PHP port made by [Alexander Obuhovich](https://github.com/aik099)
* [bumblebee framework (C#)](https://github.com/patrickherrmann/Bumblebee) - same idea, nice implementation
Release Notes
-------------
* [Version 1.20 Release Notes](https://github.com/yandex-qatools/htmlelements/releases/tag/htmlelements-1.20.0)
* [Version 1.19 Release Notes](https://github.com/yandex-qatools/htmlelements/releases/tag/htmlelements-1.19)
* [Version 1.18 Release Notes](https://github.com/yandex-qatools/htmlelements/releases/tag/htmlelements-1.18)
* [Version 1.17 Release Notes](https://github.com/yandex-qatools/htmlelements/releases/tag/htmlelements-1.17)
* [Version 1.16 Release Notes](https://github.com/yandex-qatools/htmlelements/releases/tag/htmlelements-1.16)
* [Version 1.15 Release Notes](https://github.com/yandex-qatools/htmlelements/releases/tag/htmlelements-1.15)
* [Version 1.14 Release Notes](https://github.com/yandex-qatools/htmlelements/releases/tag/htmlelements-1.14)
* [Version 1.13 Release Notes](https://github.com/yandex-qatools/htmlelements/releases/tag/htmlelements-1.13)
* [Version 1.12 Release Notes](https://github.com/yandex-qatools/htmlelements/releases/tag/htmlelements-1.12)
* [Version 1.11 Release Notes](https://github.com/yandex-qatools/htmlelements/blob/master/releasenotes/1.11-releasenotes.ru.md)
* [Version 1.10 Release Notes](https://github.com/yandex-qatools/htmlelements/blob/master/releasenotes/1.10-releasenotes.ru.md)
* [Version 1.9 Release Notes](https://github.com/yandex-qatools/htmlelements/blob/master/releasenotes/1.9-releasenotes.ru.md)
Include Html Elements in your project
-------------------------------------
Maven dependencies for Html Elements core:
```xml
ru.yandex.qatools.htmlelements
htmlelements-java
1.21.0
```
And for Thucydides integration:
```xml
ru.yandex.qatools.htmlelements
htmlelements-thucydides
1.21.0
```
Or you can include all modules at once if needed:
```xml
ru.yandex.qatools.htmlelements
htmlelements-all
1.21.0
```
Since 1.15 Java 8 is required. Please use 1.14 for Java 7 support.
Create blocks of elements
-------------------------
For example, let's create a block for the search form on the page http://www.yandex.com:
```java
@Name("Search form")
@FindBy(xpath = "//form")
public class SearchArrow extends HtmlElement {
@Name("Search request input")
@FindBy(id = "searchInput")
private TextInput requestInput;
@Name("Search button")
@FindBy(className = "b-form-button__input")
private Button searchButton;
public void search(String request) {
requestInput.sendKeys(request);
searchButton.click();
}
}
```
Construct page object using created blocks
------------------------------------------
You can easily use created blocks in page objects:
```java
public class SearchPage {
private SearchArrow searchArrow;
// Other blocks and elements here ...
public SearchPage(WebDriver driver) {
PageFactory.initElements(new HtmlElementDecorator(new HtmlElementLocatorFactory(driver)), this);
}
public void search(String request) {
searchArrow.search(request);
}
// Other methods here ...
}
```
Use page objects in your tests
------------------------------
Created page objects can be used in your tests. This makes tests more concise, easier to maintain, and easy to write.
```java
public class SampleTest {
private WebDriver driver = new FirefoxDriver();
private SearchPage searchPage = new SearchPage(driver);
@Before
public void loadPage() {
driver.get("http://www.yandex.com");
}
@Test
public void sampleTest() {
searchPage.search("yandex");
// Some assertion here
}
@After
public void closeDriver() {
driver.quit();
}
}
```
Questions?
----------
In case you can't find an answer in documentation and examples provided above, you can ask it on StackOverflow with the
[](http://stackoverflow.com/questions/tagged/htmlelements) tag.