webdriver-user-agent 7.5 → 7.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9260c1a33a202278f16eadeb8c2e3e925e28896eccf6aaf778bc127460e4dbd2
-  data.tar.gz: 70e9b164502d0c04e60c8391e8c6b8164ea6259846cecbe29212353cbf3d45cd
+  metadata.gz: c8f285c93bdc6daea5d101e3a61b973a82c9e25152ec14fbd90223ea382cd4ab
+  data.tar.gz: ff356f5cf939d1ea35ec8197ec9ccbc455c203458729da220016f7d861961b20
 SHA512:
-  metadata.gz: e81485d6bf53586daae8c220ce77a8795bf576744eb19e6f6a45951f2dfea4079faadbc86ef540a8a939af0d240c35d9b5c460a719d089453e40ee2102d74736
-  data.tar.gz: 25524c3865c8a54ce01f3c62d46c214fa33b6f1475aea1f5321268ab5c003796f0d40a807efcd16e8198bef8b02f3cfbeffbcf909842cb12162c0f7997621297
+  metadata.gz: da7de1ce472978582caf214a2588dfe2b6248179076e221f7797a9fc218212bb4793682923ab42d3a229d5c8c9f9f1e002e0a18c823f5cd9f185923c73d33232
+  data.tar.gz: e191c01c8ed048d4b1812ebc78a45a0a6cab912848ea9c789a0b7a68f5481b5e51f66d4fe41c4388da590db7ccdf7a8b8d80f6947b562585efd15bbbd15a22ee

data/.ruby-version

@@ -1 +1 @@
-ruby-2.4.1
+ruby-3.1.2

data/ChangeLog

@@ -1,3 +1,23 @@
+=== Version 7.9 / 2022-5-25
+* Enhancements (Thanks samnissen)
+  * Fixed yaml load issues with latest psych gem (Thanks samnissen)
+  * Fixed a bug with Safari browser (Thanks samnissen)
+  * Updated to Ruby 3.1.2 (Thanks sandeepnagra)
+
+=== Version 7.8 / 2020-7-10
+* Enhancements (Thanks samnissen)
+  * Updated devices
+  * Fixed provided options and updated unit tests
+
+=== Version 7.7 / 2020-7-10
+* version yanked
+
+=== Version 7.6 / 2019-2-11
+* Enhancements (Thanks samnissen)
+  * Added support for setting browswer language
+  * Replaced deprecated selenium switches
+  * Allowed Safari browser and updated requirements to support it
+
 === Version 7.5 / 2017-8-22
 * Enhancements
   * Added support for modern iPhone and iPad sizes

data/README.md

@@ -25,7 +25,7 @@ provides a UserAgent.driver method to return a new web-driver with user agent an
 * :browser
 	* :firefox (default)
 	* :chrome
-  * :safari
+    * :safari
 * :agent
 	* :iphone (default)
 	* :ipad
@@ -61,6 +61,12 @@ provides a UserAgent.driver method to return a new web-driver with user agent an
 	browser.goto 'tiffany.com'
 	browser.url.should == 'http://m.tiffany.com/International.aspx'
 
+### A note on Safari
+
+In our testing, it doesn't work well. Sometimes Safari Technology Preview works better, sometimes 
+only Safari works at all. And as of May 2021, our ability to write user agent strings
+and languages for either flavor of Safari seems not to work on macOS Big Sur/Safari 14.
+
 ## Contributing
 
 1. Fork it

data/lib/device-info/devices.yaml

@@ -1,127 +1,174 @@
 # Desktop size sources
-# http://www.hobo-web.co.uk/best-screen-size/
-# https://en.wikipedia.org/wiki/Display_resolution#Common_display_resolutions
-# http://www.w3schools.com/browsers/browsers_display.asp
-:desktop:
-   :user_agent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_5) AppleWebKit/600.8.9 (KHTML, like Gecko) Version/8.0.8 Safari/600.8.9"
-   :portrait:
-     :width: 768
-     :height: 1024
-   :landscape:
-     :width: 1366
-     :height: 768
-:iphone_default: &iphone_default
-   :user_agent: "Mozilla/5.0 (iPhone; CPU iPhone OS 11_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/11.0 Mobile/15E148 Safari/604.1"
-   :portrait:
-     :width: 375
-     :height: 635
-   :landscape:
-     :width: 724
-     :height: 375
-:iphone: &iphone
-   <<: *iphone_default
-:iphonex:
+# - http://www.hobo-web.co.uk/best-screen-size/
+# - https://en.wikipedia.org/wiki/Display_resolution#Common_display_resolutions
+# - http://www.w3schools.com/browsers/browsers_display.asp
+
+# iPhone and iPad data added by running Simulator on macOS and visiting
+# https://whatismyviewport.com and
+# https://www.whatismybrowser.com/detect/what-is-my-user-agent
+
+# Android user agents and viewports from current android device specs.
+# Tablet: Samsung Galaxy Tab S6; Phone: Google Pixel 4
+# Determined without a simulator to account for software chrome,
+# so these figures are necessarily larger than what will be true
+# on those devices. Please feel free to submit a pull request
+# with corrected and/or expanded device values.
+---
+desktop:
+  user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.1 Safari/605.1.15
+  portrait:
+    width: 768
+    height: 1024
+  landscape:
+    width: 1366
+    height: 768
+iphone_default: &iphone_default
+  user_agent: Mozilla/5.0 (iPhone; CPU iPhone OS 13_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.1.1 Mobile/15E148 Safari/604.1
+  portrait:
+    width: 414
+    height: 719
+  landscape:
+    width: 808
+    height: 414
+iphone: &iphone
   <<: *iphone_default
-:iphone8plus: &iphone8plus
+iphone11pro:
   <<: *iphone_default
-  :portrait:
-    :width: 414
-    :height: 622
-  :landscape:
-    :width: 736
-    :height: 414
-:iphone8: &iphone8
+  portrait:
+    width: 375
+    height: 635
+  landscape:
+    width: 724
+    height: 375
+iphone11promax:
   <<: *iphone_default
-  :portrait:
-    :width: 375
-    :height: 553
-  :landscape:
-    :width: 667
-    :height: 375
-:iphone7plus:
+iphone11:
+  <<: *iphone_default
+iphonese: &iphonese
+  <<: *iphone_default
+  portrait:
+    width: 375
+    height: 553
+  landscape:
+    width: 667
+    height: 375
+iphonexr: &iphonexr
+  <<: *iphone_default
+iphonexsmax:
+  <<: *iphonexr
+iphonexs: &iphonexs
+  <<: *iphone_default
+  portrait:
+    width: 375
+    height: 635
+  landscape:
+    width: 724
+    height: 375
+iphonex:
+  <<: *iphonexs
+iphone8plus: &iphone8plus
+  <<: *iphone_default
+  portrait:
+    width: 414
+    height: 622
+  landscape:
+    width: 736
+    height: 414
+iphone8: &iphone8
+  <<: *iphonese
+iphone7plus:
   <<: *iphone8plus
-:iphone7:
+iphone7:
   <<: *iphone8
-  :portrait:
-:iphone6splus:
+iphone6splus:
   <<: *iphone8plus
-:iphone6s:
+iphone6s:
   <<: *iphone8
-:iphone6plus:
+iphone6plus:
   <<: *iphone8plus
-:iphone6:
+iphone6:
   <<: *iphone8
-:iphone5s: &iphone5s
+iphone5s: &iphone5s
   <<: *iphone_default
-  :portrait:
-    :width: 320
-    :height: 454
-  :landscape:
-    :width: 568
-    :height: 320
-:iphonese:
+  portrait:
+    width: 320
+    height: 454
+  landscape:
+    width: 568
+    height: 320
+iphonese_old:
   <<: *iphone5s
-:iphone5:
+iphone5:
   <<: *iphone5s
-:iphone4s: &iphone4s
+iphone4s: &iphone4s
   <<: *iphone_default
-  :portrait:
-    :width: 320
-    :height: 356
-  :landscape:
-    :width: 480
-    :height: 196
-:iphone4:
+  portrait:
+    width: 320
+    height: 356
+  landscape:
+    width: 480
+    height: 196
+iphone4:
   <<: *iphone4s
-:ipad: &ipad
-  :user_agent: "Mozilla/5.0 (iPad; CPU OS 11_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/11.0 Mobile/15E148 Safari/604.1"
-  :portrait:
-    :width: 768
-    :height: 954
-  :landscape:
-    :width: 1024
-    :height: 698
-:ipad_default:
+ipad: &ipad
+  user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.1.1 Safari/605.1.15
+  portrait:
+    width: 810
+    height: 1010
+  landscape:
+    width: 1080
+    height: 740
+ipad_default:
   <<: *ipad
-:ipad_pro: &ipad_pro
+ipad_pro: &ipad_pro
   <<: *ipad
-  :portrait:
-    :width: 1024
-    :height: 1296
-  :landscape:
-    :width: 1366
-    :height: 954
-:ipad_pro_12:
+  portrait:
+    width: 1024
+    height: 1292
+  landscape:
+    width: 1366
+    height: 950
+ipad_pro_12:
   <<: *ipad_pro
-:ipad_pro_10:
+ipad_pro_11:
+  <<: *ipad
+  portrait:
+    width: 834
+    height: 1120
+  landscape:
+    width: 1194
+    height: 760
+ipad_pro_9:
   <<: *ipad
-  :portrait:
-    :width: 834
-    :height: 1042
-  :landscape:
-    :width: 1112
-    :height: 764
-:ipad_pro_9:
+  portrait:
+    width: 768
+    height: 954
+  landscape:
+    width: 1024
+    height: 698
+ipad_air: &ipad_air
   <<: *ipad
-  :portrait:
-    :width: 768
-    :height: 954
-  :landscape:
-    :width: 1024
-    :height: 698
-:android_phone:
-  :user_agent: "Mozilla/5.0 (Linux; U; Android 4.0.1; en-us; sdk Build/ICS_MR0) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0 Mobile Safari/534.30"
-  :portrait:
-    :width: 320
-    :height: 356
-  :landscape:
-    :width: 480
-    :height: 196
-:android_tablet:
-  :user_agent: "Mozilla/5.0 (Linux; U; Android 3.0; en-us; GT-P7100 Build/HRI83) AppleWebkit/534.13 (KHTML, like Gecko) Version/4.0 Safari/534.13"
-  :portrait:
-    :width: 768
-    :height: 946
-  :landscape:
-    :width: 1024
-    :height: 690
+  portrait:
+    width: 834
+    height: 1038
+  landscape:
+    width: 1112
+    height: 760
+ipad_pro_10:
+  <<: *ipad_air
+android_phone:
+  user_agent: Mozilla/5.0 (Linux; Android 10; Pixel) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.87 Mobile Safari/537.36
+  portrait:
+    width: 411
+    height: 869
+  landscape:
+    width: 869
+    height: 411
+android_tablet:
+  user_agent: Mozilla/5.0 (Linux; Android 9; SAMSUNG SM-T865) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/10.1 Chrome/71.0.3578.99 Safari/537.36
+  portrait:
+    width: 800
+    height: 1280
+  landscape:
+    width: 1280
+    height: 800

data/lib/webdriver-user-agent/browser_options.rb

@@ -4,6 +4,9 @@ module Webdriver
   module UserAgent
 
     MINIMUM_MACOS_VERSION_NUMBER = 12
+    DEFAULT_BROWSER = :firefox
+    DEFAULT_AGENT = :iphone
+    DEFAULT_ORIENTATION = :portrait
 
     class BrowserOptions
 
@@ -16,7 +19,7 @@ module Webdriver
 
         options[:viewport_width], options[:viewport_height] = parse_viewport_sizes(options[:viewport_width], options[:viewport_height])
 
-        initialize_for_browser(user_agent_string)
+        initialize_for_browser(user_agent_string, opts[:accept_language_string], opts[:options])
       end
 
       def method_missing(*args, &block)
@@ -27,7 +30,7 @@ module Webdriver
       end
 
       def browser_options
-        options.except(:browser, :agent, :orientation, :user_agent_string, :viewport_width, :viewport_height)
+        options.except(:browser, :agent, :orientation, :user_agent_string, :accept_language_string, :viewport_width, :viewport_height, :safari_technology_preview)
       end
 
       private
@@ -41,20 +44,32 @@ module Webdriver
         @stp = false unless @stp.is_a?(TrueClass)
       end
 
-      def initialize_for_browser(user_agent_string)
+      def initialize_for_browser(user_agent_string, accept_language_string, driver_options = nil)
+        options[:options] ||= driver_options
+
         case options[:browser]
         when :firefox
-          profile ||= Selenium::WebDriver::Firefox::Profile.new
-          profile['general.useragent.override'] = user_agent_string
-
           options[:options] ||= Selenium::WebDriver::Firefox::Options.new
+
+          profile ||= options[:options].profile || Selenium::WebDriver::Firefox::Profile.new
+          set_keys = profile.instance_variable_get(:@additional_prefs).keys
+
+          profile['general.useragent.override'] = user_agent_string if !set_keys.include?('general.useragent.override')
+          profile['intl.accept_languages'] = accept_language_string if accept_language_string && !set_keys.include?('intl.accept_languages')
+
           options[:options].profile = profile
         when :chrome
           options[:options] ||= Selenium::WebDriver::Chrome::Options.new
-          options[:options].add_argument "--user-agent=#{user_agent_string}"
+
+          set_args = options[:options].args.map{|s| "#{s}"}.join(" ")
+          options[:options].add_argument "--user-agent=#{user_agent_string}" if !set_args.include?("--user-agent=")
+
+          set_prefs = options[:options].prefs.keys
+          options[:options].add_preference("intl.accept_languages", accept_language_string) if accept_language_string && !set_prefs.include?("intl.accept_languages")
         when :safari
+          options[:options] ||= Selenium::WebDriver::Safari::Options.new
           change_safari_user_agent_string(user_agent_string)
-          options
+          change_safari_language(accept_language_string) if accept_language_string
         else
           raise "WebDriver UserAgent currently only supports :chrome, :firefox and :safari."
         end
@@ -67,23 +82,55 @@ module Webdriver
       end
 
       def change_safari_user_agent_string(user_agent_string)
+        ua  = "\"\\\"#{user_agent_string}\\\"\"" # escape for shell quoting
+
+        safari_command_runner(ua, "CustomUserAgent")
+      end
+
+      def change_safari_language(accept_language_string)
+        parsed_safari_string = prepare_safari_string(accept_language_string)
+
+        safari_command_runner(parsed_safari_string, "AppleLanguages")
+      end
+
+      def safari_command_runner(setting, pref)
         raise "Safari requires a Mac" unless OS.mac?
 
-        ua  = "\\\"#{user_agent_string}\\\"" # escape for shell quoting
+        cmd = "defaults write com.apple.#{safari_version} #{pref} #{setting}"
+        output = `#{cmd}`
+
+        raise prepare_safari_error_message(cmd, output) unless safari_command_success?(setting, safari_version, pref, $?)
+      end
+
+      def safari_command_success?(setting, safari_version, pref, result)
+        setting_chars = "#{setting}".gsub(/\W/, '')
+        read_chars = `defaults read com.apple.#{safari_version} #{pref}`.gsub(/\W/, '')
+
+        setting_match = (setting_chars == read_chars)
+        setting_match && result.success?
+      end
+
+      def safari_version
         if @stp
           Selenium::WebDriver::Safari.technology_preview!
-          cmd = "defaults write com.apple.SafariTechnologyPreview CustomUserAgent \"#{ua}\""
-        else
-          cmd = "defaults write com.apple.Safari CustomUserAgent \"#{ua}\""
+          return "SafariTechnologyPreview"
         end
 
-        output = `#{cmd}`
+        "Safari"
+      end
 
+      def prepare_safari_error_message(cmd, output)
         error_message  = "Unable to execute '#{cmd}'. "
         error_message += "Error message reported: '#{output}'"
         error_message += "Please execute the command manually and correct any errors."
 
-        raise error_message unless $?.success?
+        error_message
+      end
+
+      def prepare_safari_string(accept_language_string)
+        ["'(", accept_language_string.split(",").map{|l|
+          "\"#{l.gsub(/\s+/,'')}\""
+        }.join(", "), ")'"].join('')
       end
 
       # Require a Mac at version 12 (Sierra) or greater

data/lib/webdriver-user-agent/core_ext/hash.rb

@@ -0,0 +1,32 @@
+class Hash
+  DEEP_SYMBOLIZE_KEYS_SYMBOLS = [:deep_symbolize_keys, :deep_symbolize_keys!].freeze
+  
+  def deep_copy
+    Marshal.load(Marshal.dump(self))
+  end
+  
+  def method_missing(sym, *args)
+    super unless DEEP_SYMBOLIZE_KEYS_SYMBOLS.include?(sym)
+    
+    self.send("alias_#{sym}")
+  end
+  
+  private
+  def alias_deep_symbolize_keys!
+    alias_hash_deep_symbolize_keys!(self)
+  end
+  
+  def alias_deep_symbolize_keys
+    alias_hash_deep_symbolize_keys!(self.deep_copy)
+  end
+  
+  def alias_hash_deep_symbolize_keys!(h)
+    h.keys.each do |k|
+      ks    = k.respond_to?(:to_sym) ? k.to_sym : k
+      h[ks] = h.delete k
+      alias_hash_deep_symbolize_keys! h[ks] if h[ks].kind_of? Hash
+    end
+    
+    h
+  end # https://stackoverflow.com/a/8379653/1651458
+end

data/lib/webdriver-user-agent/devices.rb

@@ -3,20 +3,21 @@ require 'yaml'
 module Webdriver
   module UserAgent
     module Devices
-      
+
       def devices
-        YAML.load_file devices_file
+        string_hash = YAML.safe_load_file devices_file, aliases: true
+        JSON.parse(JSON[string_hash], symbolize_names: true)
       end
 
       def resolution_for(device_name, orientation, user_width, user_height)
         return [user_width.to_i, user_height.to_i] if ((user_width.to_i + user_height.to_i) > 1)
-        
-        device = devices[device_name.downcase][orientation.downcase]
+
+        device = devices[keyify(device_name)][keyify(orientation)]
         [device[:width],device[:height]]
       end
 
       def agent_string_for(device)
-        device = (device ? device.downcase : :iphone)
+        device = (device ? keyify(device) : :iphone)
         user_agent_string = (device == :random ? random_user_agent : devices[device][:user_agent])
         raise "Unsupported user agent: '#{device}'." unless user_agent_string
         user_agent_string
@@ -24,6 +25,10 @@ module Webdriver
 
       private
       
+      def keyify(target)
+        target.downcase.to_sym
+      end
+
       def random_user_agent
         File.foreach(user_agents_file).each_with_index.reduce(nil) do |picked,pair|
           rand < 1.0/(1+pair[1]) ? pair[0] : picked

data/lib/webdriver-user-agent/driver.rb

@@ -15,15 +15,6 @@ module Webdriver
         user_agent_string ||= agent_string_for opts[:agent]
         options = BrowserOptions.new(opts, user_agent_string)
         build_driver_using options
-      ensure
-        if safari?(opts)
-          case
-          when opts[:safari_technology_preview].is_a?(TrueClass)
-            `defaults delete com.apple.SafariTechnologyPreview CustomUserAgent`
-          else
-            `defaults delete com.apple.Safari CustomUserAgent`
-          end
-        end
       end
 
       private

data/lib/webdriver-user-agent.rb

@@ -1,23 +1,25 @@
 require 'webdriver-user-agent/core_ext/symbol'
+require 'webdriver-user-agent/core_ext/hash'
 require 'webdriver-user-agent/driver'
 
 module Webdriver
   module UserAgent
-    def self.driver options={}
-      Driver.instance.for options
-    end
+    class << self
+      def driver(options = {})
+        Driver.instance.for options
+      end
 
-    def self.devices
-      Driver.instance.devices
-    end
+      def devices
+        Driver.instance.devices
+      end
 
-    def self.resolution_for device_name, orientation
-      Driver.instance.resolution_for device_name, orientation
-    end
-
-    def self.agent_string_for device
-      Driver.instance.agent_string_for device
-    end 
+      def resolution_for(device_name, orientation)
+        Driver.instance.resolution_for device_name, orientation
+      end
 
+      def agent_string_for(device)
+        Driver.instance.agent_string_for device
+      end
+    end
   end
 end

data/spec/webdriver-user-agent_spec.rb

@@ -5,17 +5,93 @@ $LOAD_PATH.unshift(File.dirname(__FILE__))
 require 'webdriver-user-agent'
 require 'selenium-webdriver'
 require 'watir'
+require 'webdrivers'
 
-CHROMEBROWSER_UICHROME_HEIGHT         = 114
-CHROMEBROWSER_UICHROME_HEIGHT_TALL    = 41
-CHROMEBROWSER_UI_MINIMUM_HEIGHT       = 158
-FIREFOXBROWSER_UICHROME_HEIGHT        = 74
+CHROMEBROWSER_UICHROME_HEIGHT         = 124
+CHROMEBROWSER_UICHROME_HEIGHT_TALL    = 50
+CHROMEBROWSER_UI_MINIMUM_HEIGHT       = 289
+FIREFOXBROWSER_UICHROME_HEIGHT        = 85
+FIREFOXBROWSER_MINIMUM_WIDTH          = 450
 SAFARIBROWSER_UICHROME_HEIGHT         = 38
+SIZE_FUDGE_FACTOR                     = 0.05
+
+RSpec.shared_examples "browser driver" do
+  it "creates the browser driver" do
+    expect("#{driver.browser}").to match(/#{Regexp.quote(browser.to_s)}/i)
+  end
+
+  it "matches the agent partial" do
+    expect(driver.execute_script(agent_script)).to include agent_match
+  end
+end
+
+RSpec.shared_examples "random browser driver" do
+  it "creates the browser driver" do
+    expect("#{driver.browser}").to match(/#{Regexp.quote(browser.to_s)}/i)
+  end
+
+  it "matches the agent partial" do
+    expect(driver.execute_script(agent_script)).not_to be_nil
+  end
+end
+
+RSpec.shared_examples "firefox size" do
+  it "matches the expected width" do
+    width_expectation = device.dig(orientation.downcase.to_sym, :width)
+    width_expectation = FIREFOXBROWSER_MINIMUM_WIDTH if width_expectation < FIREFOXBROWSER_MINIMUM_WIDTH
+    width_expectation_fudge = width_expectation.to_f * SIZE_FUDGE_FACTOR
+    expect(driver.execute_script(width_script)).to be_within(width_expectation_fudge).of(width_expectation)
+  end
+
+  it "matches the expected height" do
+    height_expectation = device.dig(orientation.downcase.to_sym, :height) - FIREFOXBROWSER_UICHROME_HEIGHT
+    height_expectation_fudge = height_expectation.to_f * SIZE_FUDGE_FACTOR
+    expect(driver.execute_script(height_script)).to be_within(height_expectation_fudge).of(height_expectation)
+  end
+end
+
+RSpec.shared_examples "safari size" do
+  it "matches the expected width" do
+    width_expectation = device.dig(orientation.downcase.to_sym, :width)
+    width_expectation_fudge = width_expectation.to_f * SIZE_FUDGE_FACTOR
+    expect(driver.execute_script(width_script)).to be_within(width_expectation_fudge).of(width_expectation)
+  end
+
+  it "matches the expected height" do
+    height_expectation = device.dig(orientation.downcase.to_sym, :height) - SAFARIBROWSER_UICHROME_HEIGHT
+    height_expectation_fudge = height_expectation.to_f * SIZE_FUDGE_FACTOR
+    expect(driver.execute_script(height_script)).to be_within(height_expectation_fudge).of(height_expectation)
+  end
+end
+
+RSpec.shared_examples "chrome size" do
+  it "matches the expected width" do
+    width_expectation = device.dig(orientation.downcase.to_sym, :width)
+    width_expectation_fudge = width_expectation.to_f * SIZE_FUDGE_FACTOR
+    expect(driver.execute_script(width_script)).to be_within(width_expectation_fudge).of(width_expectation)
+  end
+
+  it "matches the expected height" do
+    height_expectation = device.dig(orientation.downcase.to_sym, :height) - CHROMEBROWSER_UICHROME_HEIGHT
+    height_expectation_fudge = height_expectation.to_f * SIZE_FUDGE_FACTOR
+    expect(driver.execute_script(height_script)).to be_within(height_expectation_fudge).of(height_expectation)
+  end
+end
 
 describe "webdriver user agent" do
+  let(:devices) { Webdriver::UserAgent.devices }
+  let(:agent_script) { 'return navigator.userAgent' }
+  let(:width_script) { 'return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)' }
+  let(:height_script) { 'return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)' }
+
   after :each do
-    @browser.close if @browser rescue nil
-    @driver.quit if @driver rescue nil
+    driver.quit if defined?(driver) rescue Selenium::WebDriver::Error::SessionNotCreatedError
+    browser.close if defined?(browser) && browser&.is_a?(Watir::Browser)
+    `defaults delete com.apple.SafariTechnologyPreview CustomUserAgent >/dev/null 2>/dev/null`
+    `defaults delete com.apple.SafariTechnologyPreview AppleLanguages >/dev/null 2>/dev/null`
+    `defaults delete com.apple.Safari CustomUserAgent >/dev/null 2>/dev/null`
+    `defaults delete com.apple.Safari AppleLanguages >/dev/null 2>/dev/null`
+    sleep(0.5) # Safari needs time to shutdown
   end
 
   # window.innerWidth and window.innerHeight
@@ -23,37 +99,129 @@ describe "webdriver user agent" do
   # browser widths and heights
   # http://stackoverflow.com/a/8876069/1651458
 
-  it "can create a new webdriver driver using firefox and iphone (portrait) by default" do
-  	@driver = Webdriver::UserAgent.driver
-  	expect(@driver.browser).to eq(:firefox)
-  	expect(@driver.execute_script('return navigator.userAgent')).to include 'iPhone'
-  	expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).to eq(375)
-  	expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).to eq(635 - FIREFOXBROWSER_UICHROME_HEIGHT)
+  context "standard browser, agent or orientation set" do
+    let(:device) { devices[:iphone] }
+    let(:driver) { Webdriver::UserAgent.driver }
+    let(:browser) { "firefox" }
+    let(:orientation) { :portrait }
+    let(:agent_match) { 'iPhone' }
+
+    it_behaves_like "browser driver"
+    it_behaves_like "firefox size"
+  end
+  
+  context "device, browser, orientation, agent are all symbols" do
+    let(:device) { devices[:iphone] }
+    let(:device_key) { :iphone }
+    let(:browser) { :firefox }
+    let(:orientation) { :landscape }
+    let(:driver) { Webdriver::UserAgent.driver(
+      browser: browser,
+      agent: device_key,
+      orientation: orientation) }
+    let(:agent_match) { 'iPhone' }
+  
+    it_behaves_like "browser driver"
+    it_behaves_like "firefox size"
   end
+  
+  context "browser is a symbol; device, orientation, agent are all strings" do
+    let(:device) { devices[:iphone] }
+    let(:device_key) { "iPhone" }
+    let(:browser) { :firefox }
+    let(:orientation) { "Portrait" }
+    let(:driver) { Webdriver::UserAgent.driver(
+      browser: browser,
+      agent: device_key,
+      orientation: orientation) }
+    let(:agent_match) { 'iPhone' }
+  
+    it_behaves_like "browser driver"
+    it_behaves_like "firefox size"
+  end
+
+  context "Safari browser, iPhone 11 Pro Max agent, landscape orientation" do
+    let(:device) { devices[:iphone11promax] }
+    let(:orientation) { :landscape }
+    let(:driver) do
+      # --- On Safari ---
+      # Safari is a mess. We do our best to test it, but
+      # it is too unreliable. The gem will still try to provide
+      # these features for the time being. 
+      # If you are a subject matter expert, please
+      # get in touch. - Sam
 
-  it "can create a new webdriver driver using safari and iphone 6 plus, and landscape" do
-  	@driver = Webdriver::UserAgent.driver(:browser => :safari, :agent => :iphone6plus, :orientation => :landscape)
-  	expect(@driver.browser).to eq(:safari)
+      Webdriver::UserAgent.driver(
+        browser: :safari,
+        agent: :iphone11promax,
+        orientation: orientation
+      )
+    end
+    let(:browser) { "safari" }
+    let(:orientation) { :landscape }
+    let(:agent_match) { 'iPhone' }
 
-  	expect(@driver.execute_script('return navigator.userAgent')).to include 'iPhone'
-  	expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).to eq(736)
-  	expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).to eq(414 - SAFARIBROWSER_UICHROME_HEIGHT)
+    # pending("a stable, documented way to programmatically change Safari details") { it_behaves_like "browser driver" }
+    # But there doesn't seem to be any way for RSpec to handle the above?
+    # `it_behaves_like` isn't available inside `pending`, but `pending` isn't available at 
+    # the `context` level.
+    it_behaves_like "safari size"
   end
 
-  it "can create a new webdriver driver using chrome and iphone 6 plus (landscape)" do
-  	@driver = Webdriver::UserAgent.driver(:browser => :chrome, :agent => :iphone6plus, :orientation => :landscape)
-  	expect(@driver.browser).to eq(:chrome)
-  	expect(@driver.execute_script('return navigator.userAgent')).to include 'iPhone'
-  	expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).to eq(736)
-  	expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).to eq(414 - CHROMEBROWSER_UICHROME_HEIGHT)
+  context "Safari browser, iPhone 6 Plus agent, landscape orientation" do
+    let(:device) { devices[:iphone6plus] }
+    let(:orientation) { :landscape }
+    let(:driver) do
+      Webdriver::UserAgent.driver(
+        browser: :safari,
+        agent: :iphone6plus,
+        orientation: orientation
+      )
+    end
+    let(:browser) { "safari" }
+    let(:agent_match) { 'iPhone' }
+    
+    # pending("a stable, documented way to programmatically change Safari details") { it_behaves_like "browser driver" }
+    # But there doesn't seem to be any way for RSpec to handle the above?
+    # `it_behaves_like` isn't available inside `pending`, but `pending` isn't available at 
+    # the `context` level.
+    it_behaves_like "safari size"
   end
 
-  it "can create a new webdriver driver using chrome and iPad (landscape)" do
-  	@driver = Webdriver::UserAgent.driver(:browser => :chrome, :agent => :ipad, :orientation => :landscape)
-  	expect(@driver.browser).to eq(:chrome)
-  	expect(@driver.execute_script('return navigator.userAgent')).to include 'iPad'
-  	expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).to eq(1024)
-  	expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).to eq(698 - CHROMEBROWSER_UICHROME_HEIGHT)
+  context "Chrome browser, iPhone XS agent, landscape orientation" do
+    let(:device_key) { :iphonexs }
+    let(:device) { devices[device_key] }
+    let(:orientation) { :landscape }
+    let(:driver) do
+      Webdriver::UserAgent.driver(
+        browser: :chrome,
+        agent: device_key,
+        orientation: orientation
+      )
+    end
+    let(:browser) { "chrome" }
+    let(:agent_match) { 'iPhone' }
+
+    it_behaves_like "browser driver"
+    it_behaves_like "chrome size"
+  end
+
+  context "Chrome browser, iPhone XS agent, landscape orientation" do
+    let(:device_key) { :iphone6 }
+    let(:device) { devices[device_key] }
+    let(:orientation) { :landscape }
+    let(:driver) do
+      Webdriver::UserAgent.driver(
+        browser: :chrome,
+        agent: device_key,
+        orientation: orientation
+      )
+    end
+    let(:browser) { "chrome" }
+    let(:agent_match) { 'Mac OS' }
+
+    it_behaves_like "browser driver"
+    it_behaves_like "chrome size"
   end
 
   it "can create a new webdriver driver using chrome and iPad Pro (portrait)" do
@@ -72,100 +240,196 @@ describe "webdriver user agent" do
 
   	@driver = Webdriver::UserAgent.driver(:browser => :chrome, :agent => :ipad_pro, :orientation => :portrait)
   	expect(@driver.browser).to eq(:chrome)
-  	expect(@driver.execute_script('return navigator.userAgent')).to include 'iPad'
+  	expect(@driver.execute_script('return navigator.userAgent')).to include 'Mac OS'
   	expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).to eq(1024)
 
     # See above
     if @you_have_a_tall_monitor
-  	   expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).to eq(1302 - CHROMEBROWSER_UICHROME_HEIGHT)
-     end
+      expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).to eq(1302 - CHROMEBROWSER_UICHROME_HEIGHT)
+    end
   end
 
-  it "can create a new webdriver driver using firefox and android phone (landscape)" do
-    @driver = Webdriver::UserAgent.driver(:browser => :chrome, :agent => :android_phone, :orientation => :landscape)
-    expect(@driver.browser).to eq(:chrome)
-    expect(@driver.execute_script('return navigator.userAgent')).to include 'Android'
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).to eq(480)
-
-    # Chrome is apparently setting some kind of minimum height
-    # As seen on Chrome v42 on OS X Yosimite
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).to eq(CHROMEBROWSER_UI_MINIMUM_HEIGHT)
+  context "Chrome browser, Android tablet agent, landscape orientation" do
+    let(:device_key) { :android_phone }
+    let(:device) { devices[device_key] }
+    let(:orientation) { :landscape }
+    let(:driver) do
+      Webdriver::UserAgent.driver(
+        browser: :chrome,
+        agent: device_key,
+        orientation: orientation
+      )
+    end
+    let(:browser) { "chrome" }
+    let(:agent_match) { 'Android' }
 
+    it_behaves_like "browser driver"
+    it_behaves_like "chrome size"
   end
 
-  it "can create a new webdriver driver using chrome and android tablet (portrait)" do
-    @driver = Webdriver::UserAgent.driver(:browser => :chrome, :agent => :android_tablet, :orientation => :portrait)
-    expect(@driver.browser).to eq(:chrome)
-    expect(@driver.execute_script('return navigator.userAgent')).to include 'Android'
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).to eq(768)
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).to eq(873 - CHROMEBROWSER_UICHROME_HEIGHT_TALL)
+  context "Firefox browser, desktop agent, landscape orientation" do
+    let(:device_key) { :desktop }
+    let(:device) { devices[device_key] }
+    let(:orientation) { :landscape }
+    let(:driver) do
+      Webdriver::UserAgent.driver(
+        browser: :firefox,
+        agent: device_key,
+        orientation: orientation
+      )
+    end
+    let(:browser) { "firefox" }
+    let(:agent_match) { 'Mac OS' }
+
+    it_behaves_like "browser driver"
+    it_behaves_like "firefox size"
   end
 
-  it "can create a new webdriver driver using firefox and desktop (landscape)" do
-    @driver = Webdriver::UserAgent.driver(:browser => :firefox, :agent => :desktop, :orientation => :landscape)
-    expect(@driver.browser).to eq(:firefox)
-    expect(@driver.execute_script('return navigator.userAgent')).to include 'Mac OS X'
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).to eq(1366)
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).to eq(768 - FIREFOXBROWSER_UICHROME_HEIGHT)
+  context "random agent" do
+    context "no specified browser" do
+      let(:device_key) { :random }
+      let(:driver) { Webdriver::UserAgent.driver(agent: device_key) }
+      let(:browser) { :firefox }
+
+      it_behaves_like "random browser driver"
+    end
+
+    context "chrome browser" do
+      let(:device_key) { :random }
+      let(:browser) { :chrome }
+      let(:driver) do
+        Webdriver::UserAgent.driver(browser: browser, agent: device_key)
+      end
+
+      it_behaves_like "random browser driver"
+    end
   end
 
-   it "can create a new webdriver driver using firefox and random user agent" do
-    @driver = Webdriver::UserAgent.driver(:agent => :random)
-    expect(@driver.browser).to eq(:firefox)
-    expect(@driver.execute_script('return navigator.userAgent')).not_to be_nil
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).not_to eq(320)
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).not_to eq(356 - FIREFOXBROWSER_UICHROME_HEIGHT)
+  context "existing firefox profile" do
+    let(:device) { devices[:iphone] }
+    let(:profile) do
+      profile = Selenium::WebDriver::Firefox::Profile.new
+      profile["intl.accept_languages"] = "es-MX"
+      profile
+    end
+    let(:options) { Selenium::WebDriver::Firefox::Options.new(profile: profile) }
+    let(:browser) { :firefox }
+    let(:agent_match) { 'iPhone' }
+    let(:orientation) { :portrait }
+    let(:driver) { Webdriver::UserAgent.driver(browser: browser, options: options) }
+
+    it_behaves_like "browser driver"
+    it_behaves_like "firefox size"
+
+    it "absorbs the options' profile" do
+      expect(driver.execute_script("return (navigator.language || navigator.userLanguage)")).to include("es-MX")
+    end
   end
 
-  it "can create a new webdriver driver using chrome and random user agent" do
-    @driver = Webdriver::UserAgent.driver(:browser => :chrome, :agent => :random)
-    expect(@driver.browser).to eq(:chrome)
-    expect(@driver.execute_script('return navigator.userAgent')).not_to be_nil
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).not_to eq(320)
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).not_to eq(356 - CHROMEBROWSER_UICHROME_HEIGHT)
+  context "user-provided user agent string for firefox" do
+    let(:browser) { :firefox }
+    let(:user_agent) { "Mozilla/4.0 (compatible; MSIE 5.5b1; Mac_PowerPC)" }
+    let(:driver) { Webdriver::UserAgent.driver(user_agent_string: user_agent) }
+
+    it "can create a new webdriver driver" do
+      expect("#{driver.browser}").to match(/#{Regexp.quote(browser.to_s)}/i)
+
+      expect(driver.execute_script("return navigator.userAgent")).to include("Mac_PowerPC")
+    end
   end
 
-  it "can create a new webdriver driver using an existing firefox profile" do
-    profile = Selenium::WebDriver::Firefox::Profile.new
-    profile['browser.startup.homepage'] = "data:text/html,<title>hello</title>"
-    options = Selenium::WebDriver::Firefox::Options.new
-    options.profile = profile
-    @driver = Webdriver::UserAgent.driver(:browser => :firefox, options: options)
+  context "user-provided accept language string for firefox" do
+    let(:browser) { :firefox }
+    let(:language) { "es-ES, es-MX;q=0.9, es;q=0.5, *;0.4" }
+    let(:driver) { Webdriver::UserAgent.driver(accept_language_string: language) }
 
-    expect(@driver.browser).to eq(:firefox)
-    expect(@driver.execute_script('return navigator.userAgent')).to include 'iPhone'
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).to eq(375)
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).to eq(635 - FIREFOXBROWSER_UICHROME_HEIGHT)
+    it "can create a new webdriver driver" do
+      expect("#{driver.browser}").to match(/#{Regexp.quote(browser.to_s)}/i)
+
+      expect(driver.execute_script("return (navigator.language || navigator.userLanguage)")).to include("es-ES")
+    end
   end
 
-  it "can create a new webdriver driver using firefox and user-specified user agent" do
-   @driver = Webdriver::UserAgent.driver(:user_agent_string => "Mozilla/4.0 (compatible; MSIE 5.5b1; Mac_PowerPC)")
-   expect(@driver.browser).to eq(:firefox)
-   expect(@driver.execute_script('return navigator.userAgent')).to include 'Mac_PowerPC'
+  context "user-provided accept language string for safari" do
+    let(:browser) { :safari }
+    let(:language) { "es-ES, es-MX;q=0.9, es;q=0.5, *;0.4" }
+    let(:driver) {
+      Webdriver::UserAgent.driver(
+        browser: browser,
+        accept_language_string: language
+      )
+    }
 
-   @browser = Watir::Browser.new @driver
- end
+    it "can create a new webdriver driver" do
+      expect("#{driver.browser}").to match(/#{Regexp.quote(browser.to_s)}/i)
+    end
+    
+    pending("a stable, documented way to programmatically change Safari details") do
+      expect(driver.execute_script("return (navigator.language || navigator.userLanguage)")).to include("es-es")
+    end
+  end
 
-  it "can create a new webdriver driver using firefox and user-specified viewport sizes (string or int)" do
-    width = 800
-    height = 600
+  context "user-provided viewport size and agent for firefox" do
+    let(:browser) { :firefox }
+    let(:device_key) { :iphone11 }
+    let(:device) { devices[device_key] }
+    let(:width) { 800 }
+    let(:height) { 600 }
+    let(:agent_match) { 'iPhone' }
+    let(:orientation) { :portrait }
+    let(:driver) {
+      Webdriver::UserAgent.driver(
+        viewport_width: "#{width}",
+        viewport_height: height,
+        agent: device_key
+      )
+    }
 
-    @driver = Webdriver::UserAgent.driver(:viewport_width => "#{width}", :viewport_height => height, :agent => :iphone6)
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).to eq(800)
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).to eq(600 - FIREFOXBROWSER_UICHROME_HEIGHT)
- end
+    it_behaves_like "browser driver"
+    it "uses user-provided dimensions" do
+    	expect(driver.execute_script(width_script)).to eq(width)
+    	expect(driver.execute_script(height_script)).to eq(height - FIREFOXBROWSER_UICHROME_HEIGHT)
+    end
+  end
 
-  it "can create a new webdriver driver, handling for nonsense height and widths" do
-    @driver = Webdriver::UserAgent.driver(:viewport_width => "abc", :agent => :iphone8)
-    expect(@driver.execute_script('return Math.max(document.documentElement.clientWidth, window.innerWidth || 0)')).to eq(375)
-  	expect(@driver.execute_script('return Math.max(document.documentElement.clientHeight, window.innerHeight || 0)')).to eq(553 - FIREFOXBROWSER_UICHROME_HEIGHT)
- end
+  context "user-provided nonsense viewport size for firefox" do
+    let(:browser) { :firefox }
+    let(:device_key) { :iphone8 }
+    let(:device) { devices[device_key] }
+    let(:width) { "xyz" }
+    let(:agent_match) { 'iPhone' }
+    let(:orientation) { :portrait }
+    let(:driver) {
+      Webdriver::UserAgent.driver(
+        viewport_width: "#{width}",
+        agent: device_key
+      )
+    }
 
-  it "can allow using selenium driver for watir browser" do
-    @driver = Webdriver::UserAgent.driver(:browser => :firefox, :agent => :iphone, :orientation => :portrait)
-    @browser = Watir::Browser.new @driver
-    expect(@browser).to be_a(Watir::Browser)
-    expect(@browser.url).to be_a(String)
+    it_behaves_like "browser driver"
+    it_behaves_like "firefox size"
   end
 
+  context "portrait firefox iphone" do
+    let(:browser) { :firefox }
+    let(:device_key) { :iphone }
+    let(:device) { devices[device_key] }
+    let(:width) { "xyz" }
+    let(:agent_match) { 'iPhone' }
+    let(:orientation) { :portrait }
+    let(:driver) {
+      Webdriver::UserAgent.driver(
+        agent: device_key,
+        browser: browser,
+        orientation: orientation
+      )
+    }
+
+    it "can create a browser using the driver" do
+      browser = Watir::Browser.new(driver)
+
+      expect(browser).to be_a(Watir::Browser)
+      expect(browser.url).to be_a(String)
+    end
+  end
 end

data/webdriver-user-agent.gemspec

@@ -12,7 +12,7 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.name          = "webdriver-user-agent"
   gem.require_paths = ["lib"]
-  gem.version       = "7.5"
+  gem.version       = "7.9"
   gem.requirements << 'chromedriver, v2.20'
   # chromedriver v2.19 causes
     # Selenium::WebDriver::Error::NoSuchDriverError: no such session errors
@@ -23,4 +23,5 @@ Gem::Specification.new do |gem|
   gem.add_dependency 'psych'
   gem.add_development_dependency 'rspec'
   gem.add_development_dependency 'watir'
+  gem.add_development_dependency 'webdrivers'
 end

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: webdriver-user-agent
 version: !ruby/object:Gem::Version
-  version: '7.5'
+  version: '7.9'
 platform: ruby
 authors:
 - Alister Scott
 - Jeff Morgan
 - Sandeep Singh
 - Sam Nissen
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-08-21 00:00:00.000000000 Z
+date: 2022-05-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -111,6 +111,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: webdrivers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A helper gem to emulate populate device user agents and resolutions when
   using webdriver
 email:
@@ -136,6 +150,7 @@ files:
 - lib/device-info/user_agents.txt
 - lib/webdriver-user-agent.rb
 - lib/webdriver-user-agent/browser_options.rb
+- lib/webdriver-user-agent/core_ext/hash.rb
 - lib/webdriver-user-agent/core_ext/symbol.rb
 - lib/webdriver-user-agent/devices.rb
 - lib/webdriver-user-agent/driver.rb
@@ -144,7 +159,7 @@ files:
 homepage: https://github.com/alisterscott/webdriver-user-agent
 licenses: []
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -160,9 +175,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - chromedriver, v2.20
-rubyforge_project: 
-rubygems_version: 2.7.7
-signing_key: 
+rubygems_version: 3.3.7
+signing_key:
 specification_version: 4
 summary: A helper gem to emulate populate device user agents and resolutions when
   using webdriver