Troubleshooting

Installing the Gem

'NoMethodError: undefined method `size' for nil:NilClass' on bundle install

We think this is a corrupt gem tarball; Try removing the tarball and fetching it again. Check out https://github.com/saucelabs/sauce_ruby/issues/171 for more discussion or if this doesn't help

RSpec

General

• Ensure your specs are tagged :sauce => true
• Ensure you're requiring the gem in your spec_helper
• Check if the latest version of the gem solves your problem

Specs only run for the first configured browser

• Make sure you've tagged your example groups :sauce => true
• Make sure you've only configured [:browsers], not [:browser], in Sauce.config

Cucumber

General

• Ensure your features are tagged @selenium
• Check if the latest version of the gem solves your problem

Parallel Testing

Jobs on Sauce Labs can't see the system under test, Or "Test did not receive new commands for 90 seconds"

You have a port collision

If Capybara is trying to start multiple servers on the same port, only the first server will start and the rest will freak out and abort.

The gem automatically sets the Capybara port, based on the Sauce Connect usable ports and the TEST_ENV_NUMBER environment variable (Set by parallel tests).

If you have over-ridden this behaviour, or hard-set the Capybara app_host, you will need to take port collisions into account.