README.md

LabKey Selenium WebDriver Test Library

This repository contains base test classes and helpers for LabKey's functional Selenium tests.

Test Setup

1. Clone this into the server directory of your LabKey enlistment. More details on setting up a development environment can be found on labkey.org.

2. Install web browser and browser driver. In order to run the Selenium tests, you will need a web browser and the corresponding browser driver. You should install the newest driver compatible with your browser. Driver executable should be available on your system PATH.

   • Firefox
     • Geckodriver
     • Note: Firefox ESR is recommended
   • Google Chrome
     • Chromedriver
     • Note: Updates frequently and should be kept in sync with Chrome browser version
   • Other Browsers
     • Edge, Safari, Opera, etc. are not currently supported.

3. Run ./gradlew :server:testAutomation:initProperties to generate the test.properties file. If setting up a fresh development environment, this will run automatically with the root ijConfigure task.

   • Update selenium.browser to specify the browser you want to run against ("chrome" or "firefox")

4. Verify test setup

   1. Build LabKey and start server
   2. Run tests: ./gradlew :server:testAutomation:uiTests -Psuite=DRT