A maven template for Selenium 4 that has the latest dependencies so that you can just check out and start writing tests in four easy steps. If you like what you see have a look at my Selenium book Mastering Selenium Webdriver.
- Open a terminal window/command prompt
- Clone this project.
cd Selenium-Maven-Template(Or whatever folder you cloned it into)
mvn clean verify
All dependencies should now be downloaded and the example google cheese test will have run successfully in headless mode (Assuming you have Firefox installed in the default location)
What should I know?
- To run any unit tests that test your Selenium framework you just need to ensure that all unit test file names end, or start with "test" and they will be run as part of the build.
- The maven failsafe plugin has been used to create a profile with the id "selenium-tests". This is active by default, but if you want to perform a build without running your selenium tests you can disable it using:
mvn clean verify -P-selenium-tests
- The maven-failsafe-plugin will pick up any files that end in IT by default. You can customise this is you would prefer to use a custom identifier for your Selenium tests.
- It looks like SafariDriver is no longer playing nicely and we are waiting on Apple to fix it... Running safari driver locally in server mode and connecting to it like a grid seems to be the workaround.
Yes you can specify which browser to use by using one of the following on the command line:
If you want to toggle the use of chrome or firefox in headless mode set the headless flag (by default the headless flag is set to true)
You don't need to worry about downloading the IEDriverServer, EdgeDriver, ChromeDriver , OperaChromiumDriver, or GeckoDriver binaries, this project will do that for you automatically.
You can specify a grid to connect to where you can choose your browser, browser version and platform:
You can even specify multiple threads (you can do it on a grid as well!):
You can also specify a proxy to use
If the tests fail screenshots will be saved in
If you need to force a binary overwrite you can do:
It's not working!!!
You have probably got outdated driver binaries, by default they are not overwritten if they already exist to speed things up. You have two options:
mvn clean verify -Doverwrite.binaries=true
- Delete the
selenium_standalone_binariesfolder in your resources directory
Brave fails when in headless mode
Currently, Brave seems to be a bit flaky when running in headless mode, I would suggest running with
It's looking for the Brave binary in the wrong location
You probably don't have the brave binary installed in one of the default locations that this codebase is expecting. That's OK though, you can specify it by seeting the following system property: