Guidebook is an extension library and style guide for Scalatest Selenium DSL for even simpler regression testing and producing a guidebook-style report for your tests.
- Add the following to your build.sbt
libraryDependencies ++= Seq(
"com.github.wongelz" %% "guidebook" % "0.4.5" % Test
)
testOptions in Test ++= Seq(
Tests.Argument(TestFrameworks.ScalaTest, "-o"),
Tests.Argument(TestFrameworks.ScalaTest, "-C", "com.github.wongelz.guidebook.GuidebookReporter")
)
(Optional) If parallel browser windows (suite executions) are causing problems
parallelExecution in Test := false
-
Your test classes should extend
Guidebook -
Run your tests using sbt. You need to specify a webdriver location for each browser you are testing. eg. to test using Chrome and Firefox (gecko):
sbt -Dwebdriver.chrome.driver=/path/to/chromedriver -Dwebdriver.gecko.driver=/path/to/geckodriver test
- Your test report will be available in
target/guidebook/index.html.
- Changing the default screen size
testOptions in Test += Tests.Argument(TestFrameworks.ScalaTest, "-Dscreen.default.size=640x1024")
- Additional screen sizes
Guidebook can resize the browser to different sizes at the conclusion of each test and take a screenshot at each size.
An additional report will be generated for each additional size, giving you view of how your site appears on different screen sizes. Note that there is no test execution under these sizes.
Up to 5 additional sizes can be configured.
testOptions in Test ++= Seq(
Tests.Argument(TestFrameworks.ScalaTest, "-Dscreen.1.size=640x1024"),
Tests.Argument(TestFrameworks.ScalaTest, "-Dscreen.2.size=600x400"),
...
Tests.Argument(TestFrameworks.ScalaTest, "-Dscreen.5.size=2000x1000")
)