sauce_bindings 1.1.0 → 1.2.1

data/spec/unit/options_spec.rb

@@ -10,237 +10,349 @@ module SauceBindings
       allow(ENV).to receive(:[]).with('BUILD_NUMBER').and_return('11')
     end
 
-    describe 'self#chrome' do
-      it 'creates Options for Chrome' do
+    describe '::chrome' do
+      it 'uses latest Chrome version on Windows 10 by default' do
         options = Options.chrome
 
         expect(options.browser_name).to eq 'chrome'
         expect(options.browser_version).to eq 'latest'
         expect(options.platform_name).to eq 'Windows 10'
       end
+
+      it 'accepts correct Selenium Options class' do
+        browser_opts = Selenium::WebDriver::Chrome::Options.new(args: ['-foo'])
+        options = Options.chrome(selenium_options: browser_opts)
+
+        expect(options.selenium_options.dig('goog:chromeOptions', 'args')).to eq ['-foo']
+      end
+
+      it 'does not accept incorrect Selenium Options class' do
+        browser_opts = Selenium::WebDriver::Firefox::Options.new
+
+        expect { Options.chrome(selenium_options: browser_opts) }.to raise_exception(ArgumentError)
+      end
+
+      it 'accepts correct Selenium Capabilities class' do
+        browser_opts = Selenium::WebDriver::Remote::Capabilities.chrome(browser_version: '99')
+        options = Options.chrome(selenium_options: browser_opts)
+
+        expect(options.browser_version).to eq '99'
+      end
+
+      it 'does not accept incorrect Selenium Capabilities class' do
+        browser_opts = Selenium::WebDriver::Remote::Capabilities.firefox(browser_version: '99')
+
+        expect { Options.chrome(selenium_options: browser_opts) }.to raise_exception(ArgumentError)
+      end
+
+      it 'accepts base configurations' do
+        options = Options.chrome(custom_data: {foo: 'bar'})
+        options.tags = %w[foo bar]
+
+        expect(options.custom_data).to eq(foo: 'bar')
+        expect(options.tags).to eq %w[foo bar]
+      end
+
+      it 'accepts vdc configurations' do
+        options = Options.chrome(browser_version: '42.0')
+        options.page_load_strategy = 'eager'
+
+        expect(options.browser_version).to eq '42.0'
+        expect(options.page_load_strategy).to eq 'eager'
+      end
+
+      it 'accepts valid configurations' do
+        options = Options.chrome(extended_debugging: true)
+        options.capture_performance = true
+
+        expect(options.extended_debugging).to eq true
+        expect(options.capture_performance).to eq true
+      end
+
+      it 'does not accept invalid configurations' do
+        expect { Options.chrome(geckodriver_version: 'anything') }.to raise_exception(ArgumentError)
+      end
     end
 
-    describe 'self#edge' do
-      it 'creates Options for Edge' do
-        options = Options.edge
+    describe '::edge' do
+      context 'with Selenium 3' do
+        before do
+          skip('test only applies with Selenium 3') unless Selenium::WebDriver::VERSION[0] == '3'
+        end
 
-        expect(options.browser_name).to eq 'MicrosoftEdge'
-        expect(options.browser_version).to eq 'latest'
-        expect(options.platform_name).to eq 'Windows 10'
+        it 'raises exception' do
+          msg = /Selenium 3 is not compatible with the Chromium based Microsoft Edge/
+          expect { Options.edge }.to raise_error(ArgumentError, msg)
+        end
+      end
+
+      context 'with Selenium 4' do
+        before do
+          skip('test only applies with Selenium 4') unless Selenium::WebDriver::VERSION[0] == '4'
+        end
+
+        it 'uses latest Edge version on Windows 10 by default' do
+          options = Options.edge
+
+          expect(options.browser_name).to eq 'MicrosoftEdge'
+          expect(options.browser_version).to eq 'latest'
+          expect(options.platform_name).to eq 'Windows 10'
+        end
+
+        it 'accepts correct Selenium Options class' do
+          browser_opts = Selenium::WebDriver::Edge::Options.new(args: ['-foo'])
+          options = Options.edge(selenium_options: browser_opts)
+
+          expect(options.selenium_options.dig('ms:edgeOptions', 'args')).to eq ['-foo']
+        end
+
+        it 'does not accept incorrect Selenium Options class' do
+          browser_opts = Selenium::WebDriver::Chrome::Options.new
+
+          expect { Options.edge(selenium_options: browser_opts) }.to raise_exception(ArgumentError)
+        end
+
+        it 'accepts correct Selenium Capabilities class' do
+          browser_opts = Selenium::WebDriver::Remote::Capabilities.edge(browser_version: '99')
+          options = Options.edge(selenium_options: browser_opts)
+
+          expect(options.browser_version).to eq '99'
+        end
+
+        it 'does not accept incorrect Selenium Capabilities class' do
+          browser_opts = Selenium::WebDriver::Remote::Capabilities.chrome(browser_version: '99')
+
+          expect { Options.edge(selenium_options: browser_opts) }.to raise_exception(ArgumentError)
+        end
+
+        it 'accepts base configurations' do
+          options = Options.edge(custom_data: {foo: 'bar'})
+          options.tags = %w[foo bar]
+
+          expect(options.custom_data).to eq(foo: 'bar')
+          expect(options.tags).to eq %w[foo bar]
+        end
+
+        it 'accepts vdc configurations' do
+          options = Options.edge(browser_version: '42.0')
+          options.page_load_strategy = 'eager'
+
+          expect(options.browser_version).to eq '42.0'
+          expect(options.page_load_strategy).to eq 'eager'
+        end
+
+        it 'accepts valid configurations' do
+          options = Options.edge(edgedriver_version: '99')
+          options.selenium_version = '3.14'
+
+          expect(options.selenium_version).to eq '3.14'
+          expect(options.edgedriver_version).to eq '99'
+        end
+
+        it 'does not accept invalid configurations' do
+          expect { Options.edge(chromedriver_version: 'anything') }.to raise_exception(ArgumentError)
+        end
       end
     end
 
-    describe 'self#firefox' do
-      it 'creates Options for Firefox' do
+    describe '::firefox' do
+      it 'uses latest Firefox version on Windows 10 by default' do
         options = Options.firefox
 
         expect(options.browser_name).to eq 'firefox'
         expect(options.browser_version).to eq 'latest'
         expect(options.platform_name).to eq 'Windows 10'
       end
+
+      it 'accepts correct Selenium Options class' do
+        browser_opts = Selenium::WebDriver::Firefox::Options.new(args: ['-foo'])
+        options = Options.firefox(selenium_options: browser_opts)
+
+        expect(options.selenium_options.dig('moz:firefoxOptions', 'args')).to eq ['-foo']
+      end
+
+      it 'does not accept incorrect Selenium Options class' do
+        browser_opts = Selenium::WebDriver::Chrome::Options.new
+
+        expect { Options.firefox(selenium_options: browser_opts) }.to raise_exception(ArgumentError)
+      end
+
+      it 'accepts correct Selenium Capabilities class' do
+        browser_opts = Selenium::WebDriver::Remote::Capabilities.firefox(browser_version: '99')
+        options = Options.firefox(selenium_options: browser_opts)
+
+        expect(options.browser_version).to eq '99'
+      end
+
+      it 'does not accept incorrect Selenium Capabilities class' do
+        browser_opts = Selenium::WebDriver::Remote::Capabilities.chrome(browser_version: '99')
+
+        expect { Options.firefox(selenium_options: browser_opts) }.to raise_exception(ArgumentError)
+      end
+
+      it 'accepts base configurations' do
+        options = Options.firefox(custom_data: {foo: 'bar'})
+        options.tags = %w[foo bar]
+
+        expect(options.custom_data).to eq(foo: 'bar')
+        expect(options.tags).to eq %w[foo bar]
+      end
+
+      it 'accepts vdc configurations' do
+        options = Options.firefox(browser_version: '42.0')
+        options.page_load_strategy = 'eager'
+
+        expect(options.browser_version).to eq '42.0'
+        expect(options.page_load_strategy).to eq 'eager'
+      end
+
+      it 'accepts valid configurations' do
+        options = Options.firefox(extended_debugging: true)
+        options.selenium_version = '3.14'
+
+        expect(options.selenium_version).to eq '3.14'
+        expect(options.extended_debugging).to eq true
+      end
+
+      it 'does not accept invalid configurations' do
+        expect { Options.firefox(chromedriver_version: 'anything') }.to raise_exception(ArgumentError)
+      end
     end
 
-    describe 'self#ie' do
-      it 'creates Options for Chrome' do
+    describe '::ie' do
+      it 'uses latest IE version on Windows 10 by default' do
         options = Options.ie
 
         expect(options.browser_name).to eq 'internet explorer'
         expect(options.browser_version).to eq 'latest'
         expect(options.platform_name).to eq 'Windows 10'
       end
-    end
 
-    describe 'self#safari' do
-      it 'creates Options for Safari' do
-        options = Options.safari
+      it 'accepts correct Selenium Options class' do
+        browser_opts = Selenium::WebDriver::IE::Options.new(args: ['-foo'])
+        options = Options.ie(selenium_options: browser_opts)
 
-        expect(options.browser_name).to eq 'safari'
-        expect(options.browser_version).to eq 'latest'
-        expect(options.platform_name).to eq 'Windows 10'
+        expect(options.selenium_options.dig('se:ieOptions', 'ie.browserCommandLineSwitches')).to eq '-foo'
       end
-    end
 
-    describe '#new' do
-      let(:default_options) do
-        {'browserName' => 'chrome',
-         'browserVersion' => 'latest',
-         'platformName' => 'Windows 10',
-         'sauce:options' => {'build' => 'TEMP BUILD: 11'}}
+      it 'does not accept incorrect Selenium Options class' do
+        browser_opts = Selenium::WebDriver::Chrome::Options.new
+
+        expect { Options.ie(selenium_options: browser_opts) }.to raise_exception(ArgumentError)
       end
 
-      it 'uses latest Chrome version on Windows 10 by default' do
-        options = Options.new
+      it 'accepts correct Selenium Capabilities class' do
+        browser_opts = Selenium::WebDriver::Remote::Capabilities.ie(browser_version: '99')
+        options = Options.ie(selenium_options: browser_opts)
 
-        expect(options.browser_name).to eq 'chrome'
-        expect(options.browser_version).to eq 'latest'
-        expect(options.platform_name).to eq 'Windows 10'
+        expect(options.browser_version).to eq '99'
       end
 
-      it 'accepts provided values for browser, browser version and platform name' do
-        options = Options.new(browser_name: 'firefox',
-                              browser_version: '123',
-                              platform_name: 'Mac')
+      it 'does not accept incorrect Selenium Capabilities class' do
+        browser_opts = Selenium::WebDriver::Remote::Capabilities.chrome(browser_version: '99')
 
-        expect(options.browser_name).to eq 'firefox'
-        expect(options.browser_version).to eq '123'
-        expect(options.platform_name).to eq 'Mac'
+        expect { Options.ie(selenium_options: browser_opts) }.to raise_exception(ArgumentError)
       end
 
-      it 'accepts other w3c values' do
-        proxy = Selenium::WebDriver::Proxy.new(ssl: 'foo')
-        timeouts = {implicit: 1,
-                    page_load: 59,
-                    script: 29}
-        options = Options.new(accept_insecure_certs: true,
-                              page_load_strategy: 'eager',
-                              proxy: proxy,
-                              set_window_rect: true,
-                              unhandled_prompt_behavior: 'accept',
-                              strict_file_interactability: true,
-                              timeouts: timeouts)
+      it 'accepts base configurations' do
+        options = Options.ie(custom_data: {foo: 'bar'})
+        options.tags = %w[foo bar]
 
-        expect(options.accept_insecure_certs).to eq true
+        expect(options.custom_data).to eq(foo: 'bar')
+        expect(options.tags).to eq %w[foo bar]
+      end
+
+      it 'accepts vdc configurations' do
+        options = Options.ie(browser_version: '42.0')
+        options.page_load_strategy = 'eager'
+
+        expect(options.browser_version).to eq '42.0'
         expect(options.page_load_strategy).to eq 'eager'
-        expect(options.proxy).to eq proxy
-        expect(options.set_window_rect).to eq true
-        expect(options.unhandled_prompt_behavior).to eq 'accept'
-        expect(options.strict_file_interactability).to eq true
-        expect(options.timeouts).to eq timeouts
       end
 
-      it 'accepts Sauce Labs specific settings' do
-        custom_data = {foo: 'foo',
-                       bar: 'bar'}
-        prerun = {executable: 'http://url.to/your/executable.exe',
-                  args: ['--silent', '-a', '-q'],
-                  background: false,
-                  timeout: 120}
-        tags = %w[foo bar foobar]
-        sauce_options = {
-          avoid_proxy: true,
-          build: 'Sample Build Name',
-          capture_performance: true,
-          chromedriver_version: '71',
-          command_timeout: 2,
-          custom_data: custom_data,
-          extended_debugging: true,
-          idle_timeout: 3,
-          iedriver_version: '3.141.0',
-          max_duration: 300,
-          name: 'Sample Test Name',
-          parent_tunnel: 'Mommy',
-          prerun: prerun,
-          priority: 0,
-          public: 'team',
-          record_logs: false,
-          record_screenshots: false,
-          record_video: false,
-          screen_resolution: '10x10',
-          selenium_version: '3.141.59',
-          tags: tags,
-          time_zone: 'San Francisco',
-          tunnel_identifier: 'tunnelname',
-          video_upload_on_pass: false
-        }
-
-        options = Options.new(**sauce_options)
+      it 'accepts valid configurations' do
+        options = Options.ie(avoid_proxy: true)
+        options.selenium_version = '3.14'
 
+        expect(options.selenium_version).to eq '3.14'
         expect(options.avoid_proxy).to eq true
-        expect(options.build).to eq 'Sample Build Name'
-        expect(options.capture_performance).to eq true
-        expect(options.chromedriver_version).to eq '71'
-        expect(options.command_timeout).to eq 2
-        expect(options.custom_data).to eq custom_data
-        expect(options.extended_debugging).to eq true
-        expect(options.idle_timeout).to eq 3
-        expect(options.iedriver_version).to eq '3.141.0'
-        expect(options.max_duration).to eq 300
-        expect(options.name).to eq 'Sample Test Name'
-        expect(options.parent_tunnel).to eq 'Mommy'
-        expect(options.prerun).to eq prerun
-        expect(options.priority).to eq 0
-        expect(options.public).to eq 'team'
-        expect(options.record_logs).to eq false
-        expect(options.record_screenshots).to eq false
-        expect(options.record_video).to eq false
-        expect(options.screen_resolution).to eq '10x10'
-        expect(options.selenium_version).to eq '3.141.59'
-        expect(options.tags).to eq tags
-        expect(options.time_zone).to eq 'San Francisco'
-        expect(options.tunnel_identifier).to eq 'tunnelname'
-        expect(options.video_upload_on_pass).to eq false
       end
 
-      it 'accepts Selenium Capabilities and overrides default browser' do
-        caps = Selenium::WebDriver::Remote::Capabilities.firefox(accept_insecure_certs: true,
-                                                                 page_load_strategy: 'eager')
-        options = Options.new(selenium_options: caps)
+      it 'does not accept invalid configurations' do
+        expect { Options.ie(chromedriver_version: 'anything') }.to raise_exception(ArgumentError)
+      end
+    end
 
-        expect(options.browser_name).to eq 'firefox'
-        expect(options.accept_insecure_certs).to eq true
-        expect(options.page_load_strategy).to eq 'eager'
+    describe '::safari' do
+      it 'uses latest Safari version on latest macOS by default' do
+        options = Options.safari
+
+        expect(options.browser_name).to eq 'safari'
+        expect(options.browser_version).to eq 'latest'
+        expect(options.platform_name).to eq 'macOS 11'
       end
 
-      it 'accepts Selenium Options and overrides default browser' do
-        browser_opts = Selenium::WebDriver::Firefox::Options.new(args: ['--foo'])
-        options = Options.new(selenium_options: browser_opts)
+      it 'accepts correct Selenium Options class' do
+        browser_opts = Selenium::WebDriver::Safari::Options.new(automatic_inspection: true)
+        options = Options.safari(selenium_options: browser_opts)
 
-        expect(options.browser_name).to eq 'firefox'
-        expect(options.selenium_options['moz:firefoxOptions']).to eq('args' => ['--foo'])
+        expect(options.selenium_options['safari:automaticInspection']).to eq true
       end
 
-      it 'accepts Selenium Capabilities and Options class instances' do
-        caps = Selenium::WebDriver::Remote::Capabilities.chrome(accept_insecure_certs: true,
-                                                                page_load_strategy: 'eager')
-        browser_opts = Selenium::WebDriver::Chrome::Options.new(args: ['--foo'])
-        options = Options.new(selenium_options: [caps, browser_opts])
+      it 'does not accept incorrect Selenium Options class' do
+        browser_opts = Selenium::WebDriver::Chrome::Options.new
 
-        expect(options.page_load_strategy).to eq 'eager'
-        expect(options.accept_insecure_certs).to eq true
-        expect(options.selenium_options['goog:chromeOptions']).to eq('args' => ['--foo'])
+        expect { Options.safari(selenium_options: browser_opts) }.to raise_exception(ArgumentError)
       end
 
-      it 'accepts W3C, Sauce, Browser Options and Capabilities at the same time' do
-        caps = Selenium::WebDriver::Remote::Capabilities.chrome(page_load_strategy: 'eager')
-        browser_opts = Selenium::WebDriver::Firefox::Options.new(args: ['--foo'])
+      it 'accepts correct Selenium Capabilities class' do
+        browser_opts = Selenium::WebDriver::Remote::Capabilities.safari(browser_version: '99')
+        options = Options.safari(selenium_options: browser_opts)
 
-        options = Options.new(browser_version: '77',
-                              accept_insecure_certs: true,
-                              command_timeout: 2,
-                              time_zone: 'Alaska',
-                              selenium_options: [caps, browser_opts])
+        expect(options.browser_version).to eq '99'
+      end
 
-        expect(options.browser_name).to eq 'firefox'
-        expect(options.browser_version).to eq '77'
-        expect(options.platform_name).to eq 'Windows 10'
-        expect(options.accept_insecure_certs).to eq true
-        expect(options.command_timeout).to eq 2
-        expect(options.time_zone).to eq 'Alaska'
-        expect(options.page_load_strategy).to eq 'eager'
+      it 'does not accept incorrect Selenium Capabilities class' do
+        browser_opts = Selenium::WebDriver::Remote::Capabilities.chrome(browser_version: '99')
 
-        expect(options.selenium_options['moz:firefoxOptions']).to eq('args' => ['--foo'])
+        expect { Options.safari(selenium_options: browser_opts) }.to raise_exception(ArgumentError)
       end
 
-      it 'creates a default build value' do
-        options = Options.new
-        expect(options.build).to eq 'TEMP BUILD: 11'
+      it 'accepts base configurations' do
+        options = Options.safari(custom_data: {foo: 'bar'})
+        options.tags = %w[foo bar]
+
+        expect(options.custom_data).to eq(foo: 'bar')
+        expect(options.tags).to eq %w[foo bar]
       end
 
-      it 'raises ArgumentError if parameter is not recognized as valid' do
-        expect { Options.new(foo: 'bar') }.to raise_exception(ArgumentError)
+      it 'accepts vdc configurations' do
+        options = Options.safari(browser_version: '42.0')
+        options.page_load_strategy = 'eager'
+
+        expect(options.browser_version).to eq '42.0'
+        expect(options.page_load_strategy).to eq 'eager'
+      end
+
+      it 'accepts valid configurations' do
+        options = Options.safari(avoid_proxy: true)
+        options.selenium_version = '3.14'
+
+        expect(options.selenium_version).to eq '3.14'
+        expect(options.avoid_proxy).to eq true
+      end
+
+      it 'does not accept invalid configurations' do
+        expect { Options.safari(chromedriver_version: 'anything') }.to raise_exception(ArgumentError)
       end
     end
 
     describe '#accessors' do
       it 'parses w3c values' do
         proxy = Selenium::WebDriver::Proxy.new(ssl: 'foo')
-        timeouts = {implicit: 1,
-                    page_load: 59,
-                    script: 29}
 
-        options = Options.new
+        options = Options.firefox
 
-        options.browser_name = 'firefox'
         options.browser_version = '7'
         options.platform_name = 'macOS 10.14'
         options.accept_insecure_certs = true
@@ -249,7 +361,9 @@ module SauceBindings
         options.set_window_rect = true
         options.unhandled_prompt_behavior = 'accept'
         options.strict_file_interactability = true
-        options.timeouts = timeouts
+        options.implicit_wait_timeout = 1
+        options.page_load_timeout = 59
+        options.script_timeout = 29
 
         expect(options.browser_name).to eq 'firefox'
         expect(options.browser_version).to eq '7'
@@ -260,7 +374,9 @@ module SauceBindings
         expect(options.set_window_rect).to eq true
         expect(options.unhandled_prompt_behavior).to eq 'accept'
         expect(options.strict_file_interactability).to eq true
-        expect(options.timeouts).to eq timeouts
+        expect(options.implicit_wait_timeout).to eq 1
+        expect(options.page_load_timeout).to eq 59
+        expect(options.script_timeout).to eq 29
       end
 
       it 'parses Sauce values' do
@@ -272,17 +388,13 @@ module SauceBindings
                   timeout: 120}
         tags = %w[foo bar foobar]
 
-        options = Options.new
+        options = Options.firefox
 
-        options.avoid_proxy = true
         options.build = 'Sample Build Name'
-        options.capture_performance = true
-        options.chromedriver_version = '71'
         options.command_timeout = 2
         options.custom_data = custom_data
         options.extended_debugging = true
         options.idle_timeout = 3
-        options.iedriver_version = '3.141.0'
         options.max_duration = 300
         options.name = 'Sample Test Name'
         options.parent_tunnel = 'Mommy'
@@ -299,15 +411,11 @@ module SauceBindings
         options.tunnel_identifier = 'tunnelname'
         options.video_upload_on_pass = false
 
-        expect(options.avoid_proxy).to eq true
         expect(options.build).to eq 'Sample Build Name'
-        expect(options.capture_performance).to eq true
-        expect(options.chromedriver_version).to eq '71'
         expect(options.command_timeout).to eq 2
         expect(options.custom_data).to eq custom_data
         expect(options.extended_debugging).to eq true
         expect(options.idle_timeout).to eq 3
-        expect(options.iedriver_version).to eq '3.141.0'
         expect(options.max_duration).to eq 300
         expect(options.name).to eq 'Sample Test Name'
         expect(options.parent_tunnel).to eq 'Mommy'
@@ -328,9 +436,6 @@ module SauceBindings
 
     describe '#merge_capabilities' do
       it 'loads options from configuration' do
-        timeouts = {implicit: 1,
-                    page_load: 59,
-                    script: 29}
         custom_data = {foo: 'foo',
                        bar: 'bar'}
         prerun = {executable: 'http://url.to/your/executable.exe',
@@ -339,9 +444,10 @@ module SauceBindings
                   timeout: 120}
         tags = %w[foo bar foobar]
 
-        options = Options.new
         yaml = YAML.load_file('spec/options.yml')
-        options.merge_capabilities(yaml['example_values'])
+        example_values = yaml['example_values']
+        options = Options.send(example_values.delete('browser_name'))
+        options.merge_capabilities(example_values)
 
         expect(options.browser_name).to eq 'firefox'
         expect(options.browser_version).to eq '123'
@@ -351,16 +457,15 @@ module SauceBindings
         expect(options.set_window_rect).to eq true
         expect(options.unhandled_prompt_behavior).to eq 'accept'
         expect(options.strict_file_interactability).to eq true
-        expect(options.timeouts).to eq timeouts
-        expect(options.avoid_proxy).to eq true
+        expect(options.implicit_wait_timeout).to eq 1
+        expect(options.page_load_timeout).to eq 59
+        expect(options.script_timeout).to eq 29
         expect(options.build).to eq 'Sample Build Name'
-        expect(options.capture_performance).to eq true
-        expect(options.chromedriver_version).to eq '71'
         expect(options.command_timeout).to eq 2
         expect(options.custom_data).to eq custom_data
         expect(options.extended_debugging).to eq true
         expect(options.idle_timeout).to eq 3
-        expect(options.iedriver_version).to eq '3.141.0'
+        expect(options.geckodriver_version).to eq '0.23'
         expect(options.max_duration).to eq 300
         expect(options.name).to eq 'Sample Test Name'
         expect(options.parent_tunnel).to eq 'Mommy'
@@ -379,7 +484,7 @@ module SauceBindings
       end
 
       it 'raises exception if value not recognized' do
-        options = Options.new
+        options = Options.chrome
         yaml = YAML.load_file('spec/options.yml')
 
         msg = 'foo is not a valid parameter for Options class'
@@ -388,34 +493,39 @@ module SauceBindings
     end
 
     describe '#capabilities' do
+      it 'errors when timeouts are milliseconds' do
+        expect { Options.chrome(implicit_wait_timeout: 601).capabilities }.to raise_error(ArgumentError)
+        expect { Options.chrome(page_load_timeout: 601).capabilities }.to raise_error(ArgumentError)
+        expect { Options.chrome(script_timeout: 601).capabilities }.to raise_error(ArgumentError)
+      end
+
       it 'correctly generates capabilities for w3c values' do
         proxy = Selenium::WebDriver::Proxy.new(ssl: 'foo')
-        timeouts = {implicit: 1,
-                    page_load: 59,
-                    script: 29}
-
-        options = Options.new(browser_name: 'firefox',
-                              platform_name: 'Mac',
-                              accept_insecure_certs: true,
-                              page_load_strategy: 'eager',
-                              proxy: proxy,
-                              set_window_rect: true,
-                              unhandled_prompt_behavior: 'accept',
-                              strict_file_interactability: true,
-                              timeouts: timeouts)
+
+        options = Options.firefox(platform_name: 'Mac',
+                                  accept_insecure_certs: true,
+                                  page_load_strategy: 'eager',
+                                  proxy: proxy,
+                                  set_window_rect: true,
+                                  unhandled_prompt_behavior: 'accept',
+                                  strict_file_interactability: true,
+                                  implicit_wait_timeout: 1,
+                                  page_load_timeout: 59,
+                                  script_timeout: 29)
+        proxy_type = Selenium::WebDriver::VERSION[0] == '3' ? 'MANUAL' : 'manual'
 
         expect(options.capabilities).to eq('browserName' => 'firefox',
                                            'browserVersion' => 'latest',
                                            'platformName' => 'Mac',
                                            'acceptInsecureCerts' => true,
                                            'pageLoadStrategy' => 'eager',
-                                           'proxy' => {'proxyType' => 'MANUAL', 'sslProxy' => 'foo'},
+                                           'proxy' => {'proxyType' => proxy_type, 'sslProxy' => 'foo'},
                                            'setWindowRect' => true,
                                            'unhandledPromptBehavior' => 'accept',
                                            'strictFileInteractability' => true,
-                                           'timeouts' => {'implicit' => 1,
-                                                          'pageLoad' => 59,
-                                                          'script' => 29},
+                                           'timeouts' => {'implicit' => 1000,
+                                                          'pageLoad' => 59_000,
+                                                          'script' => 29_000},
                                            'sauce:options' => {'build' => 'TEMP BUILD: 11'})
       end
 
@@ -427,15 +537,13 @@ module SauceBindings
                   background: false,
                   timeout: 120}
         tags = %w[foo bar foobar]
-        sauce_options = {avoid_proxy: true,
-                         build: 'Sample Build Name',
+        sauce_options = {build: 'Sample Build Name',
                          capture_performance: true,
                          chromedriver_version: '71',
                          command_timeout: 2,
                          custom_data: custom_data,
                          extended_debugging: true,
                          idle_timeout: 3,
-                         iedriver_version: '3.141.0',
                          max_duration: 300,
                          name: 'Sample Test Name',
                          parent_tunnel: 'Mommy',
@@ -446,13 +554,12 @@ module SauceBindings
                          record_screenshots: false,
                          record_video: false,
                          screen_resolution: '10x10',
-                         selenium_version: '3.141.59',
                          tags: tags,
                          time_zone: 'San Francisco',
                          tunnel_identifier: 'tunnelname',
                          video_upload_on_pass: false}
 
-        options = Options.new(**sauce_options)
+        options = Options.chrome(**sauce_options)
 
         prerun_caps = {'executable' => 'http://url.to/your/executable.exe',
                        'args' => ['--silent', '-a', '-q'],
@@ -463,7 +570,6 @@ module SauceBindings
                                            'browserVersion' => 'latest',
                                            'platformName' => 'Windows 10',
                                            'sauce:options' => {'build' => 'Sample Build Name',
-                                                               'avoidProxy' => true,
                                                                'capturePerformance' => true,
                                                                'chromedriverVersion' => '71',
                                                                'commandTimeout' => 2,
@@ -471,7 +577,6 @@ module SauceBindings
                                                                                 'bar' => 'bar'},
                                                                'extendedDebugging' => true,
                                                                'idleTimeout' => 3,
-                                                               'iedriverVersion' => '3.141.0',
                                                                'maxDuration' => 300,
                                                                'name' => 'Sample Test Name',
                                                                'parentTunnel' => 'Mommy',
@@ -482,18 +587,19 @@ module SauceBindings
                                                                'recordScreenshots' => false,
                                                                'recordVideo' => false,
                                                                'screenResolution' => '10x10',
-                                                               'seleniumVersion' => '3.141.59',
                                                                'tags' => %w[foo bar foobar],
                                                                'timeZone' => 'San Francisco',
                                                                'tunnelIdentifier' => 'tunnelname',
                                                                'videoUploadOnPass' => false})
       end
 
-      it 'correctly generates capabilities for selenium object values' do
+      it 'correctly generates capabilities for selenium object values Selenium 3' do
+        skip unless Selenium::WebDriver::VERSION[0] == '3'
+
         caps = Selenium::WebDriver::Remote::Capabilities.chrome(accept_insecure_certs: true,
                                                                 page_load_strategy: 'eager')
         browser_opts = Selenium::WebDriver::Chrome::Options.new(args: ['--foo'])
-        options = Options.new(selenium_options: [caps, browser_opts])
+        options = Options.chrome(selenium_options: [caps, browser_opts])
 
         jwp_defaults = {'cssSelectorsEnabled' => true,
                         'javascriptEnabled' => true,
@@ -513,6 +619,29 @@ module SauceBindings
 
         expect(options.capabilities).to eq(jwp_defaults.merge(expected_caps))
       end
+
+      it 'correctly generates capabilities for selenium object values Selenium 4' do
+        skip if Selenium::WebDriver::VERSION[0] == '3'
+
+        caps = Selenium::WebDriver::Remote::Capabilities.chrome(accept_insecure_certs: true)
+        browser_opts = Selenium::WebDriver::Chrome::Options.new(args: ['--foo'],
+                                                                page_load_strategy: 'eager')
+        options = Options.chrome(selenium_options: [caps, browser_opts])
+
+        expect(options.accept_insecure_certs).to eq true
+        expect(options.page_load_strategy).to eq 'eager'
+        expect(options.selenium_options.dig('goog:chromeOptions', 'args')).to eq ['--foo']
+
+        expected_caps = {'browserName' => 'chrome',
+                         'browserVersion' => 'latest',
+                         'platformName' => 'Windows 10',
+                         'acceptInsecureCerts' => true,
+                         'pageLoadStrategy' => 'eager',
+                         'sauce:options' => {'build' => 'TEMP BUILD: 11'},
+                         'goog:chromeOptions' => {'args' => ['--foo']}}
+
+        expect(options.capabilities).to eq expected_caps
+      end
     end
   end
 end