Project

govuk_test

0.01
The project is in a healthy, maintained state
Test configuration and dependencies for applications on GOV.UK
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Development

Runtime

 Project Readme

GOV.UK Test

Gem to package test dependencies and config for GOV.UK applications. Cousin of govuk_app_config.

Installation

gem "govuk_test"

And then execute:

$ bundle

Usage

Somewhere in your spec_helper.rb, rails_helper.rb, or spec/support/govuk_test.rb put:

GovukTest.configure

This will configure Capybara to run any JavaScript enabled tests against a Selenium driven instance of headless Google Chrome.

If you need to use this as a root user (such as within some docker containers) you will need to set a GOVUK_TEST_CHROME_NO_SANDBOX environment variable.

You can reuse the Selenium options for headless Google Chrome for configuring other Selenium driven tests, such as Jasmine:

class ChromeHeadlessJasmineConfigurer < JasmineSeleniumRunner::ConfigureJasmine
  def selenium_options
    { options: GovukTest.headless_chrome_selenium_options }
  end
end

Should you need to configure the options for your application the recommended approach is to re-register the headless Google Chrome driver:

GovukTest.configure

Capybara.register_driver :headless_chrome do |app|
  chrome_options = GovukTest.headless_chrome_selenium_options
  chrome_options.add_argument("--disable-web-security")
  chrome_options.add_argument("--window-size=1400,1400")

  Capybara::Selenium::Driver.new(
    app,
    browser: :chrome,
    desired_capabilities: { acceptInsecureCerts: true },
    options: chrome_options,
  )
end

License

The gem is available as open source under the terms of the MIT License.