https://github.com/aquality-automation/aquality-selenium-java
Aquality Selenium is a library built over Selenium WebDriver tool that allows to automate work with web browsers. Selenium WebDriver requires some skill and experience. So, Aquality Selenium suggests simplified and most importantly safer and more stable way to work with Selenium WebDriver.
https://github.com/aquality-automation/aquality-selenium-java
automation browserstack java pageobject qa qatools selenium selenoid zalenium
Last synced: about 2 months ago
JSON representation
Aquality Selenium is a library built over Selenium WebDriver tool that allows to automate work with web browsers. Selenium WebDriver requires some skill and experience. So, Aquality Selenium suggests simplified and most importantly safer and more stable way to work with Selenium WebDriver.
- Host: GitHub
- URL: https://github.com/aquality-automation/aquality-selenium-java
- Owner: aquality-automation
- License: apache-2.0
- Created: 2019-08-02T14:14:47.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-02-14T12:06:02.000Z (about 2 months ago)
- Last Synced: 2025-02-14T13:24:23.928Z (about 2 months ago)
- Topics: automation, browserstack, java, pageobject, qa, qatools, selenium, selenoid, zalenium
- Language: Java
- Homepage:
- Size: 579 KB
- Stars: 80
- Watchers: 14
- Forks: 35
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-java - Aquality Selenium
README
[](https://dev.azure.com/aquality-automation/aquality-automation/_build/latest?definitionId=2&branchName=master)
[](https://sonarcloud.io/dashboard?id=aquality-automation_aquality-selenium-java)
[](https://maven-badges.herokuapp.com/maven-central/com.github.aquality-automation/aquality-selenium)
### Overview
This package is a library designed to simplify your work with Selenium WebDriver.
You've got to use this set of methods, related to most common actions performed with web elements.
Most of performed methods are logged using LOG4J, so you can easily see a history of performed actions in your log.
We use interfaces where is possible, so you can implement your own version of target interface with no need to rewrite other classes.
> ### Breaking news!
> Starting from v4.4.0 onwards, this package requires Java 11 or higher, as Selenium has stopped support of Java 8.
> The last version available for Java 8 is [v4.3.3](https://github.com/aquality-automation/aquality-selenium-java/releases/tag/v4.3.3)
### Quick start
To start the project using aquality.selenium framework, you can [download our template BDD project by this link.](https://github.com/aquality-automation/aquality-selenium-java-template)
Alternatively, you can follow the steps below:
1. Add the dependency to your pom.xml:
```
com.github.aquality-automation
aquality-selenium
4.x.x
```
2. Create instance of Browser in your test method:
```java
Browser browser = AqualityServices.getBrowser();
```
3. Use Browser's methods directly for general actions, such as navigation, window resize, scrolling and alerts handling:
```java
browser.maximize();
browser.goTo("https://wikipedia.org");
browser.waitForPageToLoad();
```
4. Use ElementFactory class's methods to get an instance of each element.
```java
ITextBox txbSearch = AqualityServices.getElementFactory().getTextBox(By.id("searchInput"), "Search");
```
5. Call element's methods to perform action with element:
```java
txbSearch.type("Selenium WebDriver");
txbSearch.submit();
browser.waitForPageToLoad();
```
6. Use BiDi functionality to handle basic authentication:
```java
browser.network().addBasicAuthentication("domain.com", "username", "password");
```
or intercept network requests/responses:
```java
browser.network().startNetworkInterceptor((HttpHandler) request -> new HttpResponse()
.setStatus(HttpStatus.SC_OK)
.addHeader("Content-Type", MediaType.HTML_UTF_8.toString())
.setContent(utf8String("Some phrase")));
```
7. Emulate GeoLocation, Device, Touch, Media, UserAgent overrides, Disable script execution, log HTTP exchange, track Performance metrics, add initialization scripts, and more using browser.devTools() interfaces:
```java
final double latitude = 53.90772672521578;
final double longitude = 27.458060411865375;
final double accuracy = 0.97;
browser.devTools().emulation().setGeolocationOverride(latitude, longitude, accuracy);
```
See more DevTools use cases [here](./src/test/java/tests/usecases/devtools)
8. Quit browser at the end
```java
browser.quit();
```
See quick start example [here](./src/test/java/tests/usecases/QuickStartExample.java)
### Documentation
To get more details please look at documentation:
- [In English](https://github.com/aquality-automation/aquality-selenium-java/wiki/Overview-(English))
- [In Russian](https://github.com/aquality-automation/aquality-selenium-java/wiki/Overview-(Russian))
### License
Library's source code is made available under the [Apache 2.0 license](LICENSE).