Class: Browser
- Inherits:
-
Object
- Object
- Browser
- Defined in:
- lib/browser.rb,
lib/browser/rails.rb,
lib/browser/meta/id.rb,
lib/browser/meta/ie.rb,
lib/browser/version.rb,
lib/browser/meta/ios.rb,
lib/browser/meta/base.rb,
lib/browser/methods/ie.rb,
lib/browser/methods/tv.rb,
lib/browser/middleware.rb,
lib/browser/meta/mobile.rb,
lib/browser/meta/modern.rb,
lib/browser/meta/safari.rb,
lib/browser/meta/webkit.rb,
lib/browser/methods/bots.rb,
lib/browser/meta/platform.rb,
lib/browser/methods/mobile.rb,
lib/browser/methods/devices.rb,
lib/browser/methods/consoles.rb,
lib/browser/methods/language.rb,
lib/browser/methods/platform.rb,
lib/browser/action_controller.rb,
lib/browser/middleware/context.rb,
lib/browser/meta/generic_browser.rb,
lib/browser/middleware/context/additions.rb,
lib/browser/middleware/context/url_methods.rb
Defined Under Namespace
Modules: ActionController, Bots, Consoles, Devices, IE, Language, Meta, Mobile, Platform, Tv, Version Classes: Middleware, Railtie
Constant Summary collapse
- NAMES =
{ android: "Android", blackberry: "BlackBerry", chrome: "Chrome", core_media: "Apple CoreMedia", firefox: "Firefox", ie: "Internet Explorer", ipad: "iPad", iphone: "iPhone", ipod: "iPod Touch", nintendo: "Nintendo", opera: "Opera", phantom_js: "PhantomJS", psp: "PlayStation Portable", playstation: "PlayStation", quicktime: "QuickTime", safari: "Safari", xbox: "Xbox", # This must be last item, since Ruby 1.9+ has ordered keys. other: "Other", }
- VERSIONS =
{ default: %r[(?:Version|MSIE|Firefox|Chrome|CriOS|QuickTime|BlackBerry[^/]+|CoreMedia v|PhantomJS)[/ ]?([a-z0-9.]+)]i, opera: %r[(?:Opera/.*? Version/([\d.]+)|Chrome/([\d.]+).*?OPR)], ie: %r[(?:MSIE |Trident/.*?; rv:)([\d.]+)] }
Constants included from Bots
Bots::BOTS, Bots::SEARCH_ENGINES
Constants included from Language
Constants included from IE
IE::MODERN_IE, IE::TRIDENT_VERSION_REGEX
Instance Attribute Summary collapse
-
#user_agent ⇒ Object
(also: #ua)
Set browser’s UA string.
Attributes included from Language
Class Method Summary collapse
-
.modern_rules ⇒ Object
Define the rules which define a modern browser.
Instance Method Summary collapse
-
#chrome? ⇒ Boolean
Detect if browser is Chrome.
-
#core_media? ⇒ Boolean
Detect if browser is Apple CoreMedia.
-
#firefox? ⇒ Boolean
Detect if browser is Firefox.
-
#full_version ⇒ Object
Return the full version.
-
#id ⇒ Object
Get the browser identifier.
-
#initialize(options = {}) {|_self| ... } ⇒ Browser
constructor
Create a new browser instance and set the UA and Accept-Language headers.
-
#meta ⇒ Object
(also: #to_a)
Return a meta info about this browser.
-
#modern? ⇒ Boolean
Return true if browser is modern (Webkit, Firefox 17+, IE9+, Opera 12+).
-
#name ⇒ Object
Get readable browser name.
-
#opera? ⇒ Boolean
Detect if browser is Opera.
-
#phantom_js? ⇒ Boolean
Detect if browser is PhantomJS.
-
#quicktime? ⇒ Boolean
Detect if browser is QuickTime.
-
#safari? ⇒ Boolean
Detect if browser is Safari.
-
#silk? ⇒ Boolean
Detect if browser is Silk.
-
#to_s ⇒ Object
Return meta representation as string.
-
#version ⇒ Object
Return major version.
-
#webkit? ⇒ Boolean
Detect if browser is WebKit-based.
Methods included from Tv
Methods included from Bots
#bot?, detect_empty_ua!, #search_engine?
Methods included from Consoles
#console?, #nintendo?, #playstation?, #psp?, #xbox?
Methods included from Devices
#ipad?, #iphone?, #ipod?, #kindle?, #playbook?, #surface?, #tablet?, #windows_touchscreen_desktop?
Methods included from Mobile
#blackberry?, #mobile?, #opera_mini?
Methods included from Platform
#android?, #blackberry10?, #blackberry4?, #blackberry5?, #blackberry6?, #blackberry7?, #chrome_os?, #ios4?, #ios5?, #ios6?, #ios7?, #ios?, #linux?, #mac?, #platform, #windows8?, #windows?, #windows_mobile?, #windows_phone?, #windows_rt?, #windows_x64?
Methods included from IE
#compatibility_view?, #ie10?, #ie11?, #ie6?, #ie7?, #ie8?, #ie9?, #ie?
Constructor Details
#initialize(options = {}) {|_self| ... } ⇒ Browser
Create a new browser instance and set the UA and Accept-Language headers.
browser = Browser.new({
:ua => "Safari",
:accept_language => "pt-br"
})
103 104 105 106 107 108 |
# File 'lib/browser.rb', line 103 def initialize( = {}, &block) self.user_agent = ([:user_agent] || [:ua]).to_s self.accept_language = [:accept_language].to_s yield self if block end |
Instance Attribute Details
#user_agent ⇒ Object Also known as: ua
Set browser’s UA string.
40 41 42 |
# File 'lib/browser.rb', line 40 def user_agent @user_agent end |
Class Method Details
.modern_rules ⇒ Object
Define the rules which define a modern browser. A rule must be a proc/lambda or any object that implements the method
and accepts the browser object.
To redefine all rules, clear the existing rules before adding your own.
# Only Chrome Canary is considered modern.
Browser.modern_rules.clear
Browser.modern_rules << -> b { b.chrome? && b.version >= '37' }
83 84 85 |
# File 'lib/browser.rb', line 83 def self.modern_rules @modern_rules ||= [] end |
Instance Method Details
#chrome? ⇒ Boolean
Detect if browser is Chrome.
168 169 170 |
# File 'lib/browser.rb', line 168 def chrome? !!(ua =~ /Chrome|CriOS/) && !opera? end |
#core_media? ⇒ Boolean
Detect if browser is Apple CoreMedia.
148 149 150 |
# File 'lib/browser.rb', line 148 def core_media? !!(ua =~ /CoreMedia/) end |
#firefox? ⇒ Boolean
Detect if browser is Firefox.
163 164 165 |
# File 'lib/browser.rb', line 163 def firefox? !!(ua =~ /Firefox/) end |
#full_version ⇒ Object
Return the full version.
127 128 129 130 |
# File 'lib/browser.rb', line 127 def full_version _, *v = *ua.match(VERSIONS.fetch(id, VERSIONS[:default])) v.compact.first || "0.0" end |
#id ⇒ Object
Get the browser identifier.
116 117 118 119 |
# File 'lib/browser.rb', line 116 def id NAMES.keys .find {|id| respond_to?("#{id}?") ? public_send("#{id}?") : id } end |
#meta ⇒ Object Also known as: to_a
Return a meta info about this browser.
183 184 185 186 187 188 |
# File 'lib/browser.rb', line 183 def Meta.constants.each_with_object(Set.new) do |, | = Meta.const_get() .merge(.new(self).to_a) end.to_a end |
#modern? ⇒ Boolean
Return true if browser is modern (Webkit, Firefox 17+, IE9+, Opera 12+).
133 134 135 |
# File 'lib/browser.rb', line 133 def modern? self.class.modern_rules.any? {|rule| rule === self } end |
#name ⇒ Object
Get readable browser name.
111 112 113 |
# File 'lib/browser.rb', line 111 def name NAMES[id] end |
#opera? ⇒ Boolean
Detect if browser is Opera.
173 174 175 |
# File 'lib/browser.rb', line 173 def opera? !!(ua =~ /(Opera|OPR)/) end |
#phantom_js? ⇒ Boolean
Detect if browser is PhantomJS
153 154 155 |
# File 'lib/browser.rb', line 153 def phantom_js? !!(ua =~ /PhantomJS/) end |
#quicktime? ⇒ Boolean
Detect if browser is QuickTime
143 144 145 |
# File 'lib/browser.rb', line 143 def quicktime? !!(ua =~ /QuickTime/i) end |
#safari? ⇒ Boolean
Detect if browser is Safari.
158 159 160 |
# File 'lib/browser.rb', line 158 def safari? ua =~ /Safari/ && ua !~ /Chrome|CriOS|PhantomJS/ end |
#silk? ⇒ Boolean
Detect if browser is Silk.
178 179 180 |
# File 'lib/browser.rb', line 178 def silk? !!(ua =~ /Silk/) end |
#to_s ⇒ Object
Return meta representation as string.
193 194 195 |
# File 'lib/browser.rb', line 193 def to_s .to_a.join(" ") end |
#version ⇒ Object
Return major version.
122 123 124 |
# File 'lib/browser.rb', line 122 def version full_version.to_s.split(".").first end |
#webkit? ⇒ Boolean
Detect if browser is WebKit-based.
138 139 140 |
# File 'lib/browser.rb', line 138 def webkit? !!(ua =~ /AppleWebKit/i) end |