🚀 Big News: Socket Acquires Coana to Bring Reachability Analysis to Every Appsec Team.Learn more →
Socket
DemoInstallSign in
Socket
DemoInstallSign in

browser_stack_button

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

License
Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

browser_stack_button

0.0.3
Rubygems
Version published
Maintainers
1
Created
Source

BrowserStackButton

BrowserStackButton adds a button to your page to allow you to quickly and easily view the page you are looking at in BrowserStack. It is currently set up to work on a Rails project but could probably be used in Sinatra or the like.

Installation

Add this line to your application's Gemfile:

gem 'browser_stack_button'

And then execute:

$ bundle

Or install it yourself as:

$ gem install browser_stack_button

Configuration

Put your configuration in an initializer:

config/initializers/browser_stack_button.rb

BrowserStackButton.configure do |config|
  # ...
end

Browser configuration

By default BrowserStackButton will not render any buttons for any browsers. You need to set them up as described below. Refer to the Browser Stack API documentation for what each setting means.

Default options

These options are applied to all browsers, but can be overridden by the individual browser settings.

  config.default_options = {
    os: "Windows",
    start: "true",
    speed: "2",
    zoom_to_fit: "false",
    resolution: "1024x768",
    full_screen: "true",
  }

Configuring browsers

  config.browsers["IE8"] = { browser: "IE", browser_version: "8.0", os_version: "7" }
  config.browsers["IE9"] = { browser: "IE", browser_version: "9.0", os_version: "7" }
  config.browsers["IE10"] = { browser: "IE", browser_version: "10.0+Desktop", os_version: "8" }
  config.browsers["Firefox"] = { browser: "Firefox", browser_version: "22.0", os_version: "7" }
  config.browsers["Safari"] = { browser: "Safari", browser_version: "6.0", os: "OS X", os_version: "Mountain Lion" }
  config.browsers["Chrome"] = { browser: "Chrome", browser_version: "28.0", os_version: "7" }

Usage

Add the following just after your opening <body> tag:

<%= browser_stack_button %>

If you want to enable it, likely only on a staging server, you can call call BrowserStackButton.enable! in a before_filter or in your controller action if you want to enable it in the current Rails environment.

You could enable it on production for just admin users or whatever you like. We only use it on our staging server.

Sometimes you need to add additional parameters to your site url that is visited by BrowserStack. We use this for a login backdoor on our staging server which allows us to view the page as the same user we are currently logged in as. To do this, pass an additional hash to enable!:

BrowserStackButton.enable! do |button|
  # Add additional params to the url
  if user_signed_in?
    button.url_params[:backdoor] = current_user.email
  else
    button.url_params[:backdoor] = "anonymous"
  end

  # OR override the URL entirely
  browser.url = "http://example.com"
end

Once enabled, you should see a BrowserStack logo in the top left of the page. Click it to reveal a dropdown and select a browser. You will need to enable popups. When changing browsers, it is best to close the previous browser window before clicking the next one.

Todo

  • Localhost/Tunnel support
  • Extract more to javascript so it is usable outside of a Rails project.

Contributing

FAQs

Package last updated on 31 Jul 2014

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

PyPI Package Disguised as Instagram Growth Tool Harvests User Credentials

Research

PyPI Package Disguised as Instagram Growth Tool Harvests User Credentials

A deceptive PyPI package posing as an Instagram growth tool collects user credentials and sends them to third-party bot services.

By Kush Pandya  -  Jun 06, 2025
Socket Now Supports pylock.toml Files

Product

Socket Now Supports pylock.toml Files

Socket now supports pylock.toml, enabling secure, reproducible Python builds with advanced scanning and full alignment with PEP 751's new standard.

By Trevor Norris  -  Jun 05, 2025