Webdriver::User::Agent

A helper gem to emulate populate device user agents and resolutions when using webdriver

Add this line to your application's Gemfile:

gem 'webdriver-user-agent'

And then execute:

$ bundle

Or install it yourself as:

$ gem install webdriver-user-agent

provides a UserAgent.driver method to return a new web-driver with user agent and screen resolution mimicking a mobile device.

• :browser
  • :firefox (default)
  • :chrome
  • :safari
• :agent
  • :iphone (default)
  • :ipad
  • :android_phone
  • :android_tablet
  • :random
• :orientation
  • :portrait (default)
  • :landscape

require 'selenium-webdriver'
require 'webdriver-user-agent'
driver = Webdriver::UserAgent.driver(:browser => :chrome, :agent => :iphone, :orientation => :landscape)
driver.get 'http://tiffany.com'
driver.current_url.should == 'http://m.tiffany.com/International.aspx'

require 'selenium-webdriver'
require 'webdriver-user-agent'
driver = Webdriver::UserAgent.driver(:agent => :random)
driver.execute_script('return navigator.userAgent')
# random agent like "Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:0.9.2) Gecko/20010726 Netscape6/6.1"

require 'watir'
require 'webdriver-user-agent'
driver = Webdriver::UserAgent.driver(:browser => :chrome, :agent => :iphone, :orientation => :landscape)
browser = Watir::Browser.new(driver)
browser.goto 'tiffany.com'
browser.url.should == 'http://m.tiffany.com/International.aspx'

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.

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request