jdi-testing / jdi-light

Powerful Framework for UI Automation Testing on Java

JDI Light Test Automation Framework

Important

Starting from release 1.5.0 we will support JDK 11+ only. In case of any critical updates required in previous releases (for example, due to vulnarabilities), please contact to our team.

Documentation

For fast start you can go through tutorial

More links:
Documentation: https://jdi-docs.github.io/jdi-light/?java - different types of documentation from introduction and tutorial to technical methods documentation
Introduction + fast start example: https://jdi-docs.github.io/jdi-light/?java#introduction
Tutorial: https://jdi-docs.github.io/jdi-light/?java#tutorial - helps to get main ideas on practice
Tutorial repo: https://github.com/jdi-tutorials
Project templates: https://github.com/jdi-templates - for fast projects start
Examples: https://github.com/jdi-examples
How to use UI Elements examples
Increase test performance examples
How to start contribution setup environment
How to design element basic description

Introduction

JDI Light – is the test Framework for UI test automation that helps to makes your tests fast and sustainable and provide obvious and predictable test run result

Highlights

• Has simple integration with any Selenium based project that allows to increase projects stability, add user actions logs and enrich standard WebElements capabilities with new features in minutes (TBD add Guide)
• Extends Page Objects pattern with powerful UI Elements: Buttons, TextFields, Forms, Tables etc ( TBD add good links to examples)
• Write stable and predictable tests that fail only because of changing business logic or layout. No more waits, thread sleep and other flaky staff
• Increase your tests execution speed in general and especially for complex cases like search in big tables, dropdowns with hundreds elements or enter text with thousand lines
• Get detailed logs and good reports of all user actions with no effort
• Easy integration with all modern Automation tools: CI (Jenkins, TC etc.), Logging (Log4j or any other slf4j based logs), Reporting (Allure or Report Portal); Browser/Devices farms (Selenium Grid, Browser Stack, Selenoid etc.), Test Runners (TestNG, JUnit) etc.

Our plans

Ultimate Goal

Develop an automation framework based on AI that can identify and write correct stable PageObject automatically without engineers effort, generate smoke tests for application in seconds and some negative cases too. Run test execution automatically and correct tests if any changes in layout happens provide good reports for test project team and recommendations how Project can be improved

Nearest plans

Features

Useful Links

Test site: https://jdi-testing.github.io/jdi-light/

Login to get access to all pages (Login: Roman; Password: Jdi1234)

Html Elements examples: https://jdi-testing.github.io/jdi-light/html5.html

Example Html elements tests: https://github.com/jdi-testing/jdi-light/tree/master/jdi-light-html-tests

Example Scenario tests: https://github.com/jdi-testing/jdi-light/tree/master/jdi-light-examples

Site: http://jdi.epam.com/

Facebook: https://www.facebook.com/groups/jdi.framework/

You can ask your questions on StackOverflow with tag

Community and Support

Get Help in active users Slak chat: https://join.slack.com/t/jdi-family/shared_invite/zt-toag8fgg-ppPiW~lZDU9873JAiSwTJw

(Depricated) Get Help in active users Skype chat: https://join.skype.com/clvyVvnZvWqc

Contacts

Mail: [email protected]

Skype: roman.iovlev

License

jdi-light's Issues

Add tests for jdi-light Table elements

Add "unit-like" tests for each method of jdi-light elements marked with @JDIAction annotation
Table
FastTable
+ tests for complex cells
+ tests for tables as list of entities

Add tests for Parallel test runs

Add list of test examples that should run in parallel (2-3 threads)

Add Java Docs for jdi-light core other

Add Java docs for all methods in jdi-light
Should be done after Add Java Docs for jdi-light core JDIAction

Documentation on new UI locators

Css and XPath > UI
New locators features
['text']
[*'text']
<
[3]

Tests with no locators and jdi markup for applications
See examples in tests https://github.com/jdi-testing/jdi-light/blob/master/jdi-light-examples/src/test/java/io/github/epam/tests/smart/path/PathTests.java

Optimise table search speed (core and html)

Documentation on Tables

Tables
Fast Tables
Entity Tables

Setup tables
Asserts and search in Tables

Documentation on JDN and JDI Light

Generate Page Objects
Test attributes in code
Search elements rules

Add PageFactory init tests

Add test-examples for different kinds of site initialization using PageFactory.initElements

1. Init Site
2. Init list of WebPages
3. Init single WebPage
4. Init single page with no class in extends
5. Init list of pages with no class in extends
6. Init two different sites
7. Open two browsers in parallel
8. Work with 2+ sites in parallel tabs in one browser example

Documentation on move from Selenide

Dependency change
PageFactory Init
SelenideElement > UIElement
ElementsCollection > WebList or List<UIElement>

Immediate profits:
Logs
Stability
Performance
Code reduction with Forms and tables
Remove Thread sleeps and waits

Move all strings-messages in manageable settings

Move all strings in exceptions and logs in jdi-light in settings class with public static String

Implement Vue elements

Implement Vue typical elements like html elements

Migrating to Allure 2.0

Documentation for Setup test project

test properties
WebSettings
DriverSettings
Run jdi tests via console (Jenkins as example)
properties from mvn params console
properties from gradle params console
Before all tests (example testng)
Kill run web drivers

Documentation on List elements

Collections of elements
Collections of Sections

Remove Site entity

Add ability to init static pages in some folder / folders directly without JDISite class
scan expected folder and init static PageObjects

Implement Kendo UI Telerik for Angular, React and Vue elements

Implement Kendo UI Telerik typical elements support like html elements

Angular
React
Vue

Add tests for jdi-light composite elements

Add "unit-like" tests for each method of jdi-light elements marked with @JDIAction annotation
Forms
WebPages

Implement Cucumber steps for Html elements

Implement methods for Cucumber for html elements methods

See example in jdi-cucumber

1. Create new methods for Cucumber steps (Cucumber Core) - use request from the team
2. Implement steps for Cucumber
   2.1 Implement steps for Cucumber for Common Elements
   2.2 Implement steps for Cucumber for Complex Elements
   2.2 Implement steps for Cucumber for Composite Elements
3. Cover steps with tests - add JDI Light Cucumber dependency

Add first steps tutorial

Add first steps tutorial for beginners

Add URI annotation for sections as for pages

Add Java Docs for jdi-light-html core other

Add Java docs for all methods in jdi-light-html
Should be done after Add Java Docs for jdi-light-html JDIAction

Add Java Docs for jdi-light core JDIAction

Add Java docs for methods in jdi-light marked with @JDIAction annotation

Add Java Docs for jdi-light-html JDIAction

Add Java docs for methods in jdi-light-html interfaces marked with @JDIAction annotation

Add cook book for jdi-html

Add Cook book for jdi-html

Finish tests for Html elements

Add tests for rest of html elements on html page and fix html elements if necessary

Init PageObjects without Site

Add ability to init all Page Objects in folder by command
And in default folder with no ations

Documentation for simple elements

Buttons, Text Fields etc.

Add tests with using Remote web driver Sauce Labs

Add few tests as example for using SauceLabs (remote driver)
* Implement SauceLabs properties file if necessary

Add tests for jdi-light simple elements

Add "unit-like" tests for each method of jdi-light elements marked with @JDIAction annotation
UIElement

Add readme

Add readme to project

Add ability to read driver Options settings from file

For examples for ChromeOptions add property file with options
And while Chrome driver init it will get properties from this file if any

Documentation on JDI test project structure

Test project structure
UI Page Objects
Test Data, Tests, TestInit
InitPageObjets (static, dynamic)

Add cook book for jdi-light Selenide edition

Add examples how to switch Selenid project to jdi-light

Implement Bootstrap elements

Implement Bootstrap typical elements like html elements

Add tests with using Remote web driver Selenoid

Add few tests as example for using Selenoid (remote driver)
* Implement Selenoid properties file if necessary
Repository with project
https://github.com/jdi-templates/jdi-light-selenoid-template
Link to Selenoid Documentation: https://aerokube.com/selenoid/latest/

Kill browsers and drivers on Mac Os X

For now in jdi 1.0 all browsers are killed, even started not by Selenium. JDI Light doesn't handle this for now.

Add Contribute manual

Add contribute rules in readme like Report portal did

Add wait condition functionality for UI Element

Minimize Form to one string

Use Smart search for mapping elements in form

Documentation for Parallel test run

How to run tests in parallel with examples
Local
Use Custom Driver

Integration with thirdparty tools:
Selenium Grid
Browser Stack
Selenoid

Tips on parallel tests limitations (preconditions, independent test data)

Add Search by custom attribute functionality

Add ability to map custom attributes to way how to search element
Add default Annotations:
@ ById -> #elName
@ ByText -> //*[text()='elName']
@ ByClass -> .elName
@ ByType -> [type='elName']
@ ByName -> [name='elName']

Add cook book for jdi-light Selenium edition

Add examples how to switch Selenium project to jdi-light

Documentation on JDI Forms

Standard forms features
Forms without locators
Inline Forms
Forms on pages (example Login Page/Form)

Implement Test Fail handling

While test fails we should do by default:

1. Put in log elements Html code
2. Highlight element on page
3. Make a screenshot

Documentation on Composite elements

Write documentation on all methods for
Section - This means to add different types of elements on section and validate that they are not null after Section init (via Site) and use Section (parent) locator as context

• public WebElement
• WebElement
• public static WebElement
• public TextField
• TextField
• public static TextField
• extend PageObject from some BaseClass that extends Section (public class Header extends BasePage; public class BasePage extends Section); place some elements on Base Page and validate that these elements are not null
• Create Section for IFrame with @frame annotation (use this page https://jdi-testing.github.io/jdi-light/index.html) and validate that elements in IFrame are intractable
• Validate that Base action also work for section (like isDisplayed and all is() validations)
• Add tests for PageObjects that not extend Section and placed on some WebPage

Form

• Validate all form actions
• Validate changing FILL_ACTION and GET_ACTION methods
• Validate filters functionality
• Add test for form with overridden fillAction() and getAction()

WebPage

• Add @url and @title validation tests with all combinations of these annotations params (including cases where some annotations missed)
• Add tests on all Page actions
• Add the same tests as for Section
• Add tests for PageObjects that not extend WebPage and placed on some Site

Add wait vanish wait displayed etc. for elements

Create Html elements examples

We need to add description to all types of html elements
Html elements placed: http://epam.github.io/JDI/html5.html
Each section needs:

• TITLE
• Short description
• W3C link
• Mdn link
• Element Methods
• Link to code examples (later)

Html code can be changed in https://github.com/epam/JDI/tree/gh-pages

Documentation on move from Selenium to JDI Light

Dependency change
PageFactory Init
WebElement > UIElement
List<WebElement> > WebList or List<UIElement>

Immediate profits:
Logs
Stability
Performance
Code reduction with Forms and tables
Remove Thread sleeps and waits

Add tests for jdi-light complex elements

Add "unit-like" tests for each method of jdi-light elements marked with @JDIAction annotation

WebList
UIList with Section as Generic parameter
Dropdown

Documentation on Performance and Stability

Examples with Table, Dropdown and Long Text
Stable search (no waits for page load and ajax-like elements, no thread sleeps)
Examples: Suspend and Ghost buttons.