# Setting the browser
tt.browser.setting=chrome

# Setting the start page
tt.baseurl=http://example.org

import eu.tsystems.mms.tic.testframework.pageobjects.Page;

public class ExamplePage extends Page {

    @Check
    private GuiElement moreInformationLink =
        new GuiElement(this.getWebDriver(), By.partialLinkText("More information"));

    public ExamplePage(WebDriver driver) {
        super(driver);
    }

    public void clickOnMoreInformation() {
        moreInformationLink.click();
    }
}

<!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd" >
<suite name="Suite1" verbose="1" thread-count="10" configfailurepolicy="continue" parallel="false">
    <test name="Test1" parallel="methods">
        <classes>
            <class name="ExampleTest"/>
        </classes>
    </test>
</suite>

gradle test -Dhttps.proxyHost=your-proxy-host.com -Dhttps.proxyPort=8080

https.proxyHost=your-proxy-host.com
https.proxyPort=8080
https.proxyUser=
https.proxyPassword=
https.nonProxyHosts=localhost|192.168.0.1

http.proxyHost=your-proxy-host.com
http.proxyPort=8080
http.proxyUser=
http.proxyPassword=

gradle test -Djava.net.useSystemProxies=true

tt.webdriver.mode=remote
tt.selenium.server.host=localhost
tt.selenium.server.port=4444
tt.selenium.server.url=http://localhost:4444/wd/hub

tt.webdriver.mode=local
webdriver.gecko.driver="C:\\absolute\\path\to\\your\\geckodriver.exe"

# or for other browsers
webdriver.chrome.driver=...
webdriver.edge.driver=...
webdriver.ie.driver=...

-Dwebdriver.gecko.driver=C:\absolute\path\to\your\geckodriver.exe

# Only browser type
tt.browser.setting=firefox

# ... or with version
tt.browser.setting=firefox:65

WebDriver driver = WebDriverManager.getWebDriver();

WebDriver driver = WebDriverManager.getWebDriver();
WebDriver driverWindow2 = WebDriverManager.getWebDriver("window2");

// Get the session key
String key1 = WebDriverManagerUtils.getSessionKeyFrom(driver);        // key1 contains 'default'

String key2 = WebDriverManagerUtils.getSessionKeyFrom(driverWindow2); // key2 contains 'window2'

// Close all active session in the current test context.
WebDriverManager.shutdown();

// Close all active session without check the wdm.closewindows.aftertestmethods property
WebDriverManager.forceShutdown()

// Close all active session in all current parallel test threads.
WebDriverManager.forceShutdownAllThreads()

tt.wdm.closewindows.aftertestmethods=false

@Test
public void test1() {
    WebDriver driver = WebDriverManager.getWebDriver();
}

@Test
public void test2() {
    // You get the already opened session from test1
    WebDriver driver = WebDriverManager.getWebDriver();
}

private static String uuid = null;

@Test
public void test1() {
    WebDriver driver = WebDriverManager.getWebDriver();
    uuid = WebDriverManager.makeSessionExclusive(driver);
}

@Test
public void test2() {
    // Get the exclusive session
    WebDriver driver = WebDriverManager.getWebDriver(uuid);
}

DesktopWebDriverRequest myRequest = new DesktopWebDriverRequest();
myRequest.setBaseUrl("http://example.org");
myRequest.setBrowser(Browsers.firefox);
myRequest.setBrowserVersion("66");
myRequest.setSessionKey("mysession");     // if no custom session defined, the default value 'default' is set

WebDriver driver = WebDriverManager.getWebDriver(myRequest);

WebDriver driver = WebDriverManager.getWebDriver();
Optional<SessionContext> sessionContext = WebDriverSessionsManager.getSessionContext(driver);

// Switch to a window by matching title
Optional<WebDriver> optionalWebDriver
    = WebDriverUtils.switchToWindow(webDriver -> webDriver.getTitle().equals(windowTitle));

// Window context switched
optionalWebDriver.isPresent();

WebDriver driver = WebDriverManager.getWebDriver("mySession");

// Returns generated UUID of the Selenium session
String sessionId = WebDriverUtils.getSessionId(driver);

// will be "mySession"
String sessionKey = WebDriverManagerUtils.getSessionKey(driver);

import org.testng.annotations.BeforeSuite;
import org.openqa.selenium.remote.DesiredCapabilities;
import eu.tsystems.mms.tic.testframework.webdrivermanager.WebDriverManagerUtils;
import eu.tsystems.mms.tic.testframework.webdrivermanager.WebDriverProxyUtils;
import org.openqa.selenium.Proxy;

public abstract class AbstractTest extends TesterraTest {

    @BeforeSuite
    public void proxySetup() {
        WebDriverProxyUtils utils = new WebDriverProxyUtils();
        final Proxy defaultProxy = utils.getDefaultHttpProxy();
        final Proxy otherProxy = utils.createHttpProxyFromUrl(
                new URL("http://proxyUser:secretPassword@my-proxy:3128"));

        /**
         * Global browser proxy configuration
         */
        DesiredCapabilities dc = new DesiredCapabilities();
        dc.setCapability(CapabilityType.PROXY, defaultProxy);
        WebDriverManager.setGlobalExtraCapabilities(dc);

         /**
         * Browser specific proxy configuration
         */
        WebDriverManager.setUserAgentConfig(Browsers.chrome, new ChromeConfig() {
            @Override
            public void configure(ChromeOptions options) {
                options.setProxy(otherProxy);
            }
        });
    }
}

GuiElement myElement = new GuiElement(driver, By.id("elementId"));
GuiElement button1 = new GuiElement(driver, By.name("button"));
GuiElement textOutputField = new GuiElement(driver, By.xpath("//p[@id='99']"));

GuiElement upper = new GuiElement(driver, By.name("upperElement"));

// Create the sub elements
GuiElement lower = upper.getSubElement(By.name("lowerElement"));
GuiElement lower = upper.getSubElement(By.xpath(".//p[@id='element']")); (1)
GuiElement lower = upper.getSubElement(By.xpath("//p[@id='element']")); (2)
GuiElement lower = upper.getSubElement(By.xpath("./p[@id='element']")); (3)

GuiElement span = new GuiElement(driver, By.xpath("//a/span"));
int count = span.getNumberOfFoundElements();

List<GuiElement> allSpans = span.getList();

GuiElement myElement = new GuiElement(driver, By..).sensibleData();

GuiElement element = new GuiElement(driver, By.id("button"));

element.click();
element.doubleClick();
element.rightClick();

GuiElement element = new GuiElement(driver, By.id("input"));

// Enters the given text in a input or textfield.
// Any old values are automatically deleted before input.
// The type method has a value check. If the given string is NULL or empty, the method does nothing.
element.type("my text");

// The standard Selenium method is used.
// You can also use the Selenim Keys class to enter special keys.
element.sendKeys("my text");
element.sendKeys("my text" + Keys.ENTER);

// Delete the content of an input field.
element.clear();

GuiElement element = new GuiElement(driver, By.id("select"));

// Get the Select WebElement of a GuiElement
Select select = element.getSelectElement();

// You can use all Selenium Select methods to interact.
select.selectByIndex(2);
select.selectByVisibleText("option");
List<WebElements> list = select.getAllSelectedOptions();

GuiElement element = new GuiElement(driver, By.id("checkbox"));

// Only check boxes returns true, all other elements return false
boolean check = element.isSelectable();

// Check and uncheck the check box
element.select();
element.deselect();

// true = check, false = uncheck
element.select(true);

GuiElement element = new GuiElement(driver, By.id("image"));

element.scrollIntoView();

// Lets offset pixel distance from the top of the viewport
element.scrollIntoView(new Point(0, -20))

GuiElement element = new GuiElement(driver, By.id("label"));

element.mouseOver();

GuiElement source = new GuiElement(driver, By.id("elem1"));
GuiElement target = new GuiElement(driver, By.id("elem2"));

MouseActions.dragAndDropJS(source, target);

// You can add one or more DragAndDropActions
MouseActions.dragAndDropJS(source, target, DragAndDropOption.CLICK_AFTER_RELEASE);

// This method provides a swipe of an element to a relative position from the element.
int offsetX = 50;   // Pixel
int offsetY = 125;  // Pixel
MouseActions.swipeElement(source, offsetX, offsetY);

GuiElement element = new GuiElement(driver, By.id("button"));

element.highlight();

GuiElement element = new GuiElement(driver, By.id("button"));

// assertText only returns true, if the text is exactly the passed string
element.asserts().assertText("mytext");
element.asserts().assertTextContains("my");
element.asserts().assertTextContainsNot("foo");

// assertIsPresent is true, if the element can be found within the currect site
element.asserts().assertIsPresent();
element.asserts().assertIsNotPresent();

// assertIsDisplayed returns true, if the element is visible and reachable by Selenium
element.asserts().assertIsDisplayed();
element.asserts().assertIsNotDisplayed();

// CSS class checks
element.asserts().assertCssClassIsPresent("active");
element.asserts().assertCssClassIsGone("disabled");

// Visibility checks
element.asserts().assertVisible(boolean fullyVisible);
element.asserts().assertNotVisible();

GuiElement element = new GuiElement(driver, By.id("label"));

element.assertCollector().assertIsPresent();
element.assertCollector().assertText("mytext");

GuiElement element = new GuiElement(driver, By.id("label"));

element.optionalAsserts().assertIsPresent();
element.optionalAsserts().assertText("mytext");

GuiElement left = new GuiElement(driver, By.id("left"));
GuiElement right = new GuiElement(driver, By.id("right"));

left.asserts().assertLayout(Layout.outer().leftOf(right));

element.isPresent();

element.isDisplayed();

element.isVisible(boolean fullyVisible);

// The following methods are calling the standard webelement method
element.inEnabled();
element.isSelected();

// Tries to find out if an element could be selected.
element.isSelectable();

...
<a href="newpage.html" style="font-size: 20px;">My link</a>
...

GuiElement element = new GuiElement(driver, By.xpath("//a"));

String text = element.getText();                   // returns "My link"
String attr = element.getAttribute("href");        // returns "newpage.html"
String name = element.getTagName();                // returns "a"
Point point = element.getLocation();               // returns the top left corner of the element
Dimension dim = element.getSize();                 // returns width and heigth of the element
Rectangle rect = element.getRect();                // returns rectangle with location and size
String value = element.getCssValue("font-size");   // returns "20px"

...
<a href="newpage.html" style="font-size: 20px;">
    <span>My</span>
    <span>Link</span>
</a>
...

GuiElement link = new GuiElement(driver, By.xpath("//a"));
List<String> list = link.getTextsFromChildren();    // returns a list ["My", "Link"]

public class SearchPage extends Page {

    @Check
    private final GuiElement searchButton =
            new GuiElement(this.getWebDriver(), By.name("searchButton"));

    @Check
    private final GuiElement inputField =
            new GuiElement(this.getWebDriver(), By.name("inputField"));

    // constructor
    public SearchPage(WebDriver driver) {
        super(driver);
    }

    // search action on page
    public ResultPage search(String text){
        inputField.type(text);
        searchButton.click();
        return PageFactory.create(ResultPage.class, this.getWebDriver());
    }
}

import ...

public class TestClass extends TesterraTest {

    @Test
    public void myTest() {
        WebDriver driver = WebDriverManager.getWebDriver();
        HomePage homePage = PageFactory.create(HomePage.class, driver);
        SearchPage searchPage = homePage.openSearch();
        ResultPage resultPage = searchPage.search("search text");
        resultPage.assertResultSetIsNotEmpty();
        homePage = resultPage.close();
    }
}

HomePage homePage = PageFactory.create(HomePage.class, driver);

PageFactory.checkNot(searchPage.class, driver);

PageFactory.setGlobalPagesPrefix("Variation1");
//this actualy creates a Variation1BaseClass
BaseClass baseClass = PageFactory.create(BaseClass.class, driver);

// Set a global Prefix
PageFactory.setGlobalPagesPrefix("prefix");

// Set a thread local prefix. See next row about cleaning this prefix.
PageFactory.setThreadLocalPagesPrefix("prefix");

// The thread local pages prefix is not cleared automatically,
// be sure to always set the correct one or clear  itafter using.
PageFactory.clearThreadLocalPagesPrefix();

/** base page class */
abstract class ResponsiveTestPage extends Page { ... }

/**	page instantiated for width 600px or less. */
class ResponsiveTestPage_Min_600px extends ResponsiveTestPage { ... }

/** page is instantiated for width from 601 to 1199 px */
class ResponsiveTestPage_601px_1199px extends ResponsiveTestPage { ... }

/** page instantiated for width  1200 px or more. */
class ResponsiveTestPage_1200px_Max extends ResponsiveTestPage { ... }

ResponsiveTestPage testPage = Pagefactory.create(ResponsiveTestPage.class, this.getWebDriver());

# activate demo mode, default = false
tt.demomode=true

GuiElement loginButton = new GuiElement(driver, By.id('login'));
loginButton.highlight();
// renders a green frame around the loginButton Element of the current Page

@Test
@Fails(description="This test fails for reasons")
public void testItWillFail() {
    Assert.assertTrue(false);
}

public boolean browserCouldFail(MethodContext methodContext) {
    return methodContext.readSessionContexts()
                .map(SessionContext::getActualBrowserName)
                .anyMatch(s -> s.contains("internet explorer"));
}

@Test
@Fails(validator = "browserCouldFail")
public void testSomething() {
    // Perform your tests here
}

public class FailsValidator {
    public boolean expectedFailIsValid(MethodContext methodContext) {
        return true;
    }
}

@Test
@Fails(validatorClass = FailsValidator.class, validator = "expectedFailIsValid")
public void testSomething() {
    // Perform your tests here
}

# test.properties
environment=test
country=de

@Test
@Fails(description = "Failing for environment 'test' and country 'de'", validFor = {"environment=test", "country=de"})
public void testExpectedFailed() {
    Assert.fail();
}

@Test()
@Retry(maxRetries = 2)
public void testMethod() {
    // ...
}

# Set additional classes that engage a retry,
tt.failed.tests.if.throwable.classes=java.sql.SQLRecoverableException

# Set additional messages of Throwable that engage a retry,
tt.failed.tests.if.throwable.messages=failed to connect, error communicating with database

// custom Retryanalyzers need to implement the functional interface AdditionalRetryAnalyzer
public class InstantiationExceptionRetryAnalyzer implements AdditionalRetryAnalyzer {

    final String message = "failed instantiation";

    @Override
    public Optional<Throwable> analyzeThrowable(Throwable throwable, String tMessage) {
        if (throwable instanceof InstantiationException) {
            if (tMessage != null) {
                final String tMessageLC = tMessage.toLowerCase();
                boolean match = tMessageLC.contains(message);
                if (match) {
                    return Optional.of(throwable);
                }
            }
        }

        return Optional.empty();
    }
}

public class AbstractTest extends TesterraTest {

    static {
        // register the additional Analyzer,
        // which checks for "InstantiationException" and the message "failed instantiation"
        RetryAnalyzer.registerAdditionalRetryAnalyzer(new InstantiationExceptionRetryAnalyzer());
    }

}

@Test()
@NoRetry(name = "No retry because it's not allowed.", color="rgb(255, 236, 139)")
public void testMethod() {
    ...
}

# activate the dry run, default = false
tt.dryrun=true

import eu.tsystems.mms.tic.testerra.bup.BrowserUpRemoteProxyManager;
import eu.tsystems.mms.tic.testerra.bup.BrowserUpRemoteProxyServer;
import eu.tsystems.mms.tic.testframework.testing.TesterraTest;
import org.openqa.selenium.Proxy;
import org.testng.annotations.AfterSuite;
import org.testng.annotations.BeforeSuite;

import java.net.MalformedURLException;
import java.net.URL;

public class AbstractTest extends TesterraTest {

    private static BrowserUpRemoteProxyServer bupProxy = new BrowserUpRemoteProxyServer();

    @BeforeSuite
    public void setupProxy() throws MalformedURLException {
        URL apiUrl = new URL("http://localhost:8080");
        BrowserUpRemoteProxyManager bupRemoteProxyManager
                = new BrowserUpRemoteProxyManager(apiUrl);
        bupProxybupRemoteProxyManager.startServer(bupProxy);

        /* Additional Proxy setup here */
        String bmpProxyAddress = String.format("%s:%d", apiUrl.getHost(), bupProxy.getPort());

        // For selenium usage.
        Proxy proxy = new Proxy();
        proxy.setHttpProxy(bmpProxyAddress).setSslProxy(bmpProxyAddress);

        WebDriverManager.setGlobalExtraCapability(CapabilityType.PROXY, proxy);
    }

    @AfterSuite
    public void tearDownProxy() throws MalformedURLException {

        URL apiBaseUrl = new URL("http://localhost:8080");
        BrowserUpRemoteProxyManager browserUpRemoteProxyManager
                = new BrowserUpRemoteProxyManager(apiBaseUrl);

        for (Integer proxyPort : browserUpRemoteProxyManager.getProxies()) {
            BrowserUpRemoteProxyServer bupToStop = new BrowserUpRemoteProxyServer();
            bupToStop.setPort(proxyPort);
            browserUpRemoteProxyManager.stopServer(bupToStop);
        }
    }
}

BrowserUpRemoteProxyServer browserUpRemoteProxyServer = new BrowserUpRemoteProxyServer();
browserUpRemoteProxyServer.setPort(8088);

browserUpRemoteProxyManager.startServer(browserUpRemoteProxyServer);

List<Integer> portPool = new ArrayList<>();
ports.add(8090);
ports.add(8091);
ports.add(8092);
ports.add(8093);
ports.add(8094);
ports.add(8095);

BrowserUpLocalProxyManager bupLocalManager = new BrowserUpLocalProxyManager(ports);

// Start instance
BrowserUpProxyServer browserUpProxyServer = new BrowserUpProxyServer();
bupLocalManager.startServer(browserUpProxyServer);

// assert that a port of given port pool was used.
Assert.assertTrue(portPool.contains(port), "Port of range was used.");

// assert proxy is started.
Assert.assertTrue(bup1.isStarted(), "Proxy started");

final CSVTestDataReader csvTestDataReader = new CSVTestDataReader();

final List<Map<String, String>> testDataMap = csvTestDataReader.readCsvTestDataFromResource("testfiles/TestCsvReader.csv");

Assert.assertEquals(testDataMap.size(), 2);
Assert.assertEquals(testDataMap.get(0).get("id"), "AH_1");
Assert.assertEquals(testDataMap.get(1).get("id"), "AH_2");

final CSVTestDataReader csvTestDataReader = new CSVTestDataReader();

final List<TestCsvReaderBean> testDataList = csvTestDataReader.readCsvIntoBeans("testfiles/TestCsvReader.csv", TestCsvReaderBean.class);

Assert.assertNotNull(testDataList);####
Assert.assertNotEquals(testDataList.size(), 0);

final TestCsvReaderBean testCSVReader = testDataList.get(0);
final String id = testCSVReader.getId();
Assert.assertEquals(id, "AH_1");

public class TestCsvReaderBeanWithSubModel {

    private String id;
    private String name;
    private String firstName;
    private TestCsvReaderSubModel subModel;

    // getter and setter here...
}

public class TestCsvReaderSubModel {

    private String id;
    private String street;
    private String city;

    // getter and setter here...
}

tt.layoutcheck.reference.path=src/test/resources/layout-references/{tt.browser}
tt.layoutcheck.reference.nametemplate=%s.png

# Highly recommended to disable full screen for browser
tt.browser.maximize=false

# Highly recommended to switch of the demo mode for layout tests
tt.demomode=false

systemProp.file.encoding=utf-8

import eu.tsystems.mms.tic.testframework.l10n.SimpleLocalization;

GuiElement loginBtn = new GuiElement(By.linkText(SimpleLocalization.getText("BTN_LOGIN")));

LocalizedBundle defaultBundle = SimpleLocalization.setDefault(Locale.GERMAN);

Locale sessionLocale = WebDriverManager.getSessionLocale(WebDriver).orElse(Locale.getDefault());

LocalizedBundle sessionBundle = new LocalizedBundle("testdata", sessionLocale);
sessionBundle.getString("TEST_KEY");

public class LocalizedPage extends Page {

    public void switchLocale(Locale locale) {
        // Implement your language switch here
        // ...

        // Don't forget to set the sessions locale
        WebDriverManager.setSessionLocale(getWebDriver(), locale);
    }
}

gradle test -Duser.language=de

<project>
    <properties>
        <user.language>de</user.language>
        <user.country>DE</user.country>
        <argLine>-Duser.language=${user.language} -Duser.country=${user.country}</argLine>
    </properties>
</project>

mvn test -Duser.language=de -Duser.country=DE

POP3MailConnector pop3MailConnector = new POP3MailConnector();

// wait until the email with subject 'test' arrived in the InboxFolder
EmailQuery query = new EmailQuery().setSearchTerm(new SubjectTerm(subject));
Email email = pop3MailConnector.query(query).findFirst().get();

// delete all emails with this subject from the server while setting timeout and max number of polls explicitly
query.setRetryCount(5);
query.setPauseMs(2000);

Email email = pop3MailConnector.query(query).findFirst().get();

// delete mails matching the given criteria
String recipient = email.getRecipients().get(0));
String subject = email.getSubject();
String messageId = null;

pop3MailConnector.deleteMessage(recipient, RecipientType.TO, subject, messageId);

// wait until the email with subject 'test' arrived in the InboxFolder
EmailQuery query = new EmailQuery().setSearchTerm(new SubjectTerm(subject));
Email email = pop3MailConnector.query(query).findFirst().get();

try {
    Multipart content = (Multipart) email.getMessage().getContent();
    int contentCnt = content.getCount();
    String attachmentFileName = null;

    for (int i = 0; i < contentCnt; i++) {
        Part part = content.getBodyPart(i);

        // Retrieve attachment
        if (part.getDisposition().equals(Part.ATTACHMENT)) {
            attachmentFileName = part.getFileName();
        }
    }
} catch (IOException e) {
    e.printStackTrace();
} catch (MessagingException e) {
    e.printStackTrace();
}

SMTPMailConnector smtpMailConnector = new SMTPMailConnector();

// send a created message
MimeMessage createdMessage = new MimeMessage(session);
try {
    msg.addRecipients(RecipientType.TO, RECIPIENT);
    msg.addFrom(new Address[]{new InternetAddress(SENDER)});
    msg.setSubject("testerra");
    msg.setText("mail text");
} catch (MessagingException e) {
    LOGGER.error(e.toString());
}
smtpMailConnector.sendMessage(createdMessage);

// send an existing message
MimeMessage existingMessage = MailUtils.loadEmailFile("test-mail.eml");
smtpMailConnector.sendMessage(existingMessage);

ImapMailConnector imapMailConnector = new ImapMailConnector();

EmailQuery query = new EmailQuery().setSearchTerm(new SubjectTerm(subject));
imapMailConnector.query(query).findFirst().ifPresent(email -> {
    // EMail found
});

// mark all mails in inbox as seen
imapMailConnector.markAllMailsAsSeen();

// delete all mails in inbox
imapMailConnector.deleteAllMessages();

connector.getMessageCount();
connector.getMessageCount("FolderName");

IMAP_SSL_ENABLED=false
POP3_SSL_ENABLED=false
SMTP_SSL_ENABLED=true

connector.configureSessionProperties(properties -> {
    properties.put("mail.imaps.auth.ntlm.disable", true);
});

connector.getSession().setDebug(true);

DEBUG_SETTING=true

String pahtKeyStore = "your/path/to/cacert.p12";
String password = "123456";
String subject = "test";
String sentContent = "Testerra Testmail"

SMTPMailConnector smtpMailConnector = new SMTPMailConnector();
Session session = smtpMailConnector.getSession();

MimeMessage sentMessage = new MimeMessage(session);
sentMessage.setText(sentContent);
sentMessage.setSubject(subject);

// encrypt message
MimeMessage encryptedMsg = MailUtils.encryptMessageWithKeystore(sentMessage, session, pahtKeyStore, password);

smtpMailConnector.sendMessage(encryptedMsg);
Email receivedMsg = waitForMessage(subject);

// compare Mails and verify difference due to encryption
boolean areContentsEqual = MailUtils.compareSentAndReceivedEmailContents(sentMessage, receivedMsg);
Assert.assertFalse(areContentsEqual);

// decrypt message
MimeMessage decryptedMsg = MailUtils.decryptMessageWithKeystore(encryptedMsg, session, pahtKeyStore, password);
// verify receivedContent is equal to sentContent
String receivedContent = ((Multipart) decryptedMsg.getContent()).getBodyPart(0).getContent().toString();
Assert.assertEquals(receivedContent, sentContent);

common.PropertyManager - Load system properties: /path/to/your/system.properties

GuiElement element = new GuiElement(driver, By.id("label"));
DesktopWebDriverUtils utils = new DesktopWebDriverUtils();

utils.clickJS(element);

final WebDriver driver = WebDriverManager.getWebDriver();
final GuiElement hiddenUploadField = new GuiElement(driver, Locate.by().id("hidden-upload-field"));
hiddenUploadField.asserts().assertIsPresent();

// will change style to display a hidden element
JSUtils.executeScript(driver, "arguments[0].setAttribute('style', 'display:block; opacity: 1')", hiddenUploadField.getWebElement());

final WebDriver driver = WebDriverManager.getWebDriver();

// WebDriver, Path to resource file, id of the script-tag
JSUtils.implementJavascriptOnPage(driver, "js/inject/custom.js", "customJs");

<script id="customJs" type="text/javascript">
    // your javascript code here.
</script>

// define the url where to download the resource from
String downloadUrl = "https://upload.wikimedia.org/wikipedia/commons/thumb/0/0a/"+
	"S%C3%A5g_med_arm_av_valn%C3%B6t_-_Skoklosters_slott_-_92588.tif/"+
	"lossy-page1-1024px-S%C3%A5g_med_arm_av_valn%C3%B6t_-_Skoklosters_slott_-_92588.tif.jpg";

// construct the downloader
FileDownloader downloader = new FileDownloader();

// perform the download
File downloadFile = downloader.download(downloadUrl);

System.out.println("downloaded file exists:" + downloadFile.exists());

CertUtils certUtils = new CertUtils();
certUtils.setTrustAllHosts(true);

DefaultConnectionConfigurator connectionConfigurator = new DefaultConnectionConfigurator();
connectionConfigurator.useCertUtils(certUtils);
connectionConfigurator.immitateCookiesFrom(WebDriver)

FileDownloader downloader = new FileDownloader();
downloader.setConnectionConfigurator(connectionConfigurator);
downloader.setDownloadLocation("/some/directory");
downloader.setProxy(new Proxy(Proxy.Type.HTTP, new InetSocketAddress("123.0.0.1", 8080)));

downloader.cleanup();

// Will pause current thread for 1 second.
TimerUtils.sleep(1000);

// You can pass a comment as well
TimerUtils.sleep(5000, "Wait for something to happen.");

final Timer timer = new Timer(500, 15_000);
timer.executeSequence(new Timer.Sequence<Boolean>() {
    @Override
    public void run() throws Throwable {
        // sequence code here
    }
});

public MyObject runTimer() {
    final Timer timer = new Timer(500, 15_000);
    ThrowablePackedResponse<MyObject> myObjectResponse
        = timer.executeSequenceThread(new Timer.Sequence<MyObject>() {
        @Override
        public void run() throws Throwable {
            // sequence code here
            setPassState(boolean);  // exit the sequence if your condition is true before timeout
            setReturningObject(new MyObject());

        }
    });
    return myObjectResponse.getResponse();
}

WebDriver driver = WebDriverManager.getWebDriver();
// Do some test stuff with session your session

// Starting a second session for example to test concurrent interactions.
WebDriver driverWithOtherUser = WebDriverManager.getWebDriver("Session2");

// Keep alive driver while doing actions on driverWithOtherUser for 90 seconds, while refreshing all 10 seconds
final WebDriverKeepAliveSequence webDriverKeepAliveSequence = WebDriverUtils.keepWebDriverAlive(driver, 10, 90);

// Do your things with your second driver

// NOTE: Please release your WebDriverKeepAliveSequence as you dont need the lock
WebDriverUtils.removeKeepAliveForWebDriver(driver);

import com.google.common.eventbus.Subscribe;
import eu.tsystems.mms.tic.testframework.events.MethodStartEvent;
import eu.tsystems.mms.tic.testframework.logging.Loggable;

public class LogEventListener implements MethodStartEvent.Listener, Loggable {

    @Override
    @Subscribe
    public void onMethodStart(MethodStartEvent event) {
        log().info("Event logged: " + event.getMethod());
    }
}

TesterraListener.getEventBus().register(new LogEventListener());

// Update some data in data model...
methodContext.name = "new_Test_Method_Name";

TesterraListener.getEventBus().post(new ContextUpdateEvent().setContext(methodContext));

public class CustomEvent {
    public interface Listener {
        void onCustomEvent(CustomEvent event);
    }
}

@Override
@Subscribe
public void onCustomEvent(CustomEvent event) {
   log().info("Custom Event started!");
}

import eu.tsystems.mms.tic.testframework.events.InterceptMethodsEvent;

public class MyTest extends TesterraTest {

    public class MyListener implements InterceptMethodsEvent.Listener {

        @Override
        @Subscribe
        public void onInterceptMethods(InterceptMethodsEvent event) {
            event.getMethodInstances().removeIf(iMethodInstance -> true);
        }
    }

    @BeforeTest
    public void setupListener() {
        TesterraListener.getEventBus().register(new MyListener());
    }
}

import eu.tsystems.mms.tic.testframework.logging.Loggable;
import com.google.common.eventbus.Subscribe;
import org.testng.ISuite;
import org.testng.ISuiteListener;

class MySuiteListener implements ISuiteListener, Loggable {

    @Subscribe
    @Override
    public void onStart(ISuite suite) {
        log().info("Suite started");
    }
}

import com.google.common.eventbus.EventBus;
import eu.tsystems.mms.tic.testframework.listeners.AbstractReportModelListener;
import eu.tsystems.mms.tic.testframework.hooks.ModuleHook;
import eu.tsystems.mms.tic.testframework.report.TesterraListener;

public class CustomReportModuleHook implements ModuleHook {

    @Override
    public void init() {
        Report report = new Report();
        EventBus eventBus = TesterraListener.getEventBus();
        eventBus.register(new GenerateReportModelListener(report.getReportDirectory()));
    }
}

<input type="radio" name="beverage" value="tee">
<input type="radio" name="beverage" value="coffee">

// Good practice
Locate locator = Locate.prepare("//input[@name='%s' and @value='%s']").unique();
GuiElement teeOption = new GuiElement(driver, locator.with("beverage", "tee"));
GuiElement coffeeOption = new GuiElement(driver, locator.with("beverage", "coffee"));

// Bad practice
GuiElement options = new GuiElement(driver, By.name("beverage"));

<body>
    <div id="wrapper">
    <!-- HTML code-->
    <my-custom-shadow-root-element>
    <!-- #shadowRoot -->
        <div class="custom-component">
            <input id="custom-component-login-name" name="name">
        </div>
    </my-custom-shadow-root-element>
    </div>
    <!-- HTML code-->
</body>

WebDriver driver = WebDriverManager.getWebDriver();

GuiElement shadowRootElement = new GuiElement(driver, By.cssSelector("my-custom-shadow-root-element")).shadowRoot();
GuiElement inputName = shadowRootElement.getSubElement(By.xpath("//*[@id='custom-component-login-name']"));

tt.browser=chrome
tt.baseurl=http://example.org

tt.browser=firefox
tt.baseurl=http://qa.example.org

@BeforeSuite
public void setup() {
    String env = PropertyManager.getProperty("env", "");
    if (!"".equals(env)) {
        PropertyManager.loadProperties("test_" + env + ".properties");
    }
}

gradle test -Denv=qa