Selenium Cookbook

This cookbook installs and configures Selenium and WebDriver components (http://www.seleniumhq.org/).

This cookbook comes with the following Resource/Providers:

• selenium_hub - Installs and configures selenium-grid hubs.
• selenium_node - Installs and configures selenium-grid nodes with support for ChromeDriver, FirefoxDriver, HtmlUnitDriver, and InternetExplorerDriver.

PhantomJS has been deprecated and is no longer supported. It will be removed in the next major release.

Please use ghostdriver cookbook instead.

Requirements

• Chef 11.14 or higher (sensitive resource introduced)

Platforms

• CentOS, RedHat
• Mac OS X
• Ubuntu
• Windows

Cookbooks

These cookbooks are referenced with suggests, so be sure to depend on cookbooks that apply:

• windows
• nssm - Required for Windows services only (e.g. Hub and HtmlUnit running in background)

Usage

See selenium_test
cookbook for working cross platform examples. Note that provided examples in this cookbook have passwords
unencrypted for simplicity.

selenium_hub

Installs and configures selenium-grid hubs.

Requirements

• Java must be installed outside of this cookbook.

Example

Install selenium-grid hub

selenium_hub 'selenium_hub' do
  action :install
end

Attributes

This is a partial list of attributes available. See
hub
resource for the complete listing of attributes.

• name - Name attribute. The name of the service.
• host - Hostname. Defaults to null.
• port - Port. Defaults to 4444.

selenium_node

Installs and configures selenium-grid nodes with support for
ChromeDriver,
FirefoxDriver,
HtmlUnitDriver, and
InternetExplorerDriver.

Requirements

• Java must be installed outside of this cookbook.
• Browsers (e.g., chrome, firefox, etc...) must be installed outside of this cookbook.
• Linux nodes without a physical monitor require a headless display (e.g., xvfb, x11vnc, etc...) and must be installed and configured outside this cookbook.
• Mac OS X/Windows nodes (with the exception of HtmlUnitDriver) must run as a GUI service and that requires a username and password for automatic login. Note that Windows password is stored unencrypted under windows registry HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon and Mac OS X password is stored encrypted under /etc/kcpassword but it can be easily decrypted.

Example

Install selenium-grid node with Chrome, Firefox, HtmlUnit and Internet Explorer capability

selenium_node 'selenium_node' do
  username 'Administrator' if platform?('windows')
  password 'password' if platform?('windows')
  capabilities [
    {
      browserName: 'chrome',
      maxInstances: 5,
      seleniumProtocol: 'WebDriver'
    },
    {
      browserName: 'firefox',
      maxInstances: 5,
      seleniumProtocol: 'WebDriver'
    },
    {
      browserName: 'htmlunit',
      maxInstances: 1,
      platform: 'ANY',
      seleniumProtocol: 'WebDriver'
    },
    {
      browserName: 'internet explorer',
      maxInstances: 1,
      seleniumProtocol: 'WebDriver'
    }
  ]
  action :install
end

Attributes

This is a partial list of attributes available. See
node
resource for the complete listing of attributes.

• name - Name attribute. The name of the service or Windows foreground startup script.
• host - Hostname. Defaults to null.
• port - Port. Defaults to 5555.
• hubHost - Selenium-grid hub hostname. Defaults to ip.
• hubPort - Selenium-grid hub port. Defaults to 4444.
• capabilities - The following drivers are supported and installed based on capabilities:
  • ChromeDriver - Installed if capabilities contains browser name chrome
  • FirefoxDriver - Pre-installed with Selenium server
  • HtmlUnitDriver - Pre-installed with Selenium server
  • InternetExplorerDriver - 32-bit or 64-bit installed if capabilities contains browser name internet explorer
• Mac OS X/Windows only - Set both username and password to run as a GUI service or leave nil to run service in background:
  • username - Defaults to nil.
  • password - Defaults to nil. Note that Windows password is stored unencrypted under windows registry HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon and Mac OS X password is stored encrypted under /etc/kcpassword but it can be easily decrypted.
  • domain - Optional. Defaults to nil.

ChefSpec Matchers

The Selenium cookbook includes custom ChefSpec matchers you can use to test
your own cookbooks.

Example Matcher Usage

expect(chef_run).to install_selenium_hub('resource_name').with(
  port: '4444'
)

Selenium Cookbook Matchers

• install_selenium_hub(resource_name)
• install_selenium_node(resource_name)

Getting Help

• Ask specific questions on Stack Overflow.
• Report bugs and discuss potential features in Github issues.

Contributing

Please refer to CONTRIBUTING.

License

MIT - see the accompanying LICENSE file for details.