Allows to find out if a given user agent string satisfies a Browserslist browsers with the Ruby backend.

Monthly Downloads: 18,468
Programming language: Ruby
License: MIT License
Latest version: v0.2.0

browserslist_useragent gem alternatives and similar gems

Based on the "Authorization" category.
Alternatively, view browserslist_useragent gem alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of browserslist_useragent gem or a related project?

Add another 'Authorization' Gem


browserslist_useragent gem

Gem Version Build Status

Find if a given user agent string satisfies a Browserslist browsers.

Browserslist is a popular config in many front-end tools like Autoprefixer or Babel. This gem allow you to use this config in Ruby project to check user agent string and, for examplle, show “Your browsers is outdated” warning for user with old browser.


1. Setup Browserslist

Run in webpack directory to install browserslist npm package:

npm install --save-dev browserslist

Add the following lines to your webpack config to generate the browsers.jsonfile during build step:

const browserslist = require('browserslist')
const fs = require('fs')

fs.writeFileSync('./browsers.json', JSON.stringify(browserslist()))

In a Rails/Webpacker environment add the above lines to the top of your app/config/webpack/environment.js file.

Add browsers.json file to .gitignore.

2. Install gem

Add this line to Gemfile

gem 'browserslist_useragent'

Run bundle install.

3. Add helper

Define new helper in app/helpers/application_helper.rb:

def supported_browser?
  @browsers ||= JSON.parse(File.read(PATH_TO_BROWSERS_JSON))
  matcher = BrowserslistUseragent::Match.new(@browsers, request.user_agent)
  matcher.browser? && matcher.version?(allow_higher: true)

4. Use helper in template

Put a warning message for users with an unsupported browser in app/views/layouts/_unsupported_browser_warning and add this check in application layout:

  - if !supported_browser?
    render 'layouts/unsupported_browser_warning'

Separated projects

If you have separated projects for Ruby backend and Node.js frontend, you will prefer to get browsers.json over HTTP.

  path.join(__dirname, 'public', 'browsers.json'),
  JSON.stringify(browserslist(undefined, { path: path.join(__dirname, '..') }))

Gets browserslist.json over HTTP (with caching) once (per web application instance) and use it to match user agent for every request:

# caches http response locally with etag
http_client = Faraday.new do |builder|
  builder.use Faraday::HttpCache, store: Rails.cache
  builder.adapter Faraday.default_adapter

@browsers = JSON.parse(
  http_client.get(FRONTEND_HOST + '/browsers.json').body


BrowserslistUseragent::Match is the main class performing matching user agent string to browserslist.

It provides 2 methods:

  • version?(allow_higher: false) - determines matching browser and it's version
  • browser? - determines matching only browser family
require 'browserslist_useragent'

matcher = BrowserslistUseragent::Match.new(
  ['Firefox 53'],
  'Mozilla/5.0 (Windows NT 10.0; rv:54.0) Gecko/20100101 Firefox/53.0'
matcher.browser? # returns true
matcher.version? # return true

matcher = BrowserslistUseragent::Match.new(
  ['Firefox 54'],
  'Mozilla/5.0 (Windows NT 10.0; rv:54.0) Gecko/20100101 Firefox/53.0'
matcher.browser? # returns true
matcher.version? # return false

Supported browsers

Chrome, Firefox, Safari, IE, Edge

PRs to add more browserslist supported browsers are welcome 👋


  • All browsers on iOS (Chrome, Firefox etc) use Safari's WebKit as the underlying engine, and hence will be resolved to Safari. Since browserslist is usually used for transpiling / autoprefixing for browsers, this behaviour is what's intended in most cases, but might surprise you otherwise.
  • Right now, Chrome for Android and Firefox for Android are resolved to their desktop equivalents. The caniuse database does not currently store historical data for these browsers separately (except the last version) See #156

Development (with Docker))))

After checking out the repo, run:

docker-compose run app bundle install

Run tests with:

docker-compose run app bundle exec rspec

Run RuboCop with:

docker-compose run app bundle exec rubocop


Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/browserslist-useragent-ruby.


The gem is available as open source under the terms of the MIT License.

*Note that all licence references and agreements mentioned in the browserslist_useragent gem README section above are relevant to that project's source code only.