Module: TestCentricity::Browsers

Includes:
Capybara::DSL
Defined in:
lib/testcentricity_web/browser_helper.rb

Class Method Summary collapse

Class Method Details

.browser_size(browser, orientation) ⇒ Object 



132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
 
# File 'lib/testcentricity_web/browser_helper.rb', line 132

def self.browser_size(browser, orientation)
  device_name = browser.gsub(/\s+/, '').downcase.to_sym
  device = get_devices[device_name]
  if device
    width = device[:css_width]
    height = device[:css_height]
    default_orientation = device[:default_orientation].to_sym
    if orientation
      orientation.downcase.to_sym == default_orientation ?
          size = [width, height] :
          size = [height, width]
    else
      size = [width, height]
    end
  else
    size = [1650, 1000]
  end
  size
end

.close_all_browser_instances ⇒ Object 



61
62
63
64
65
66
 
# File 'lib/testcentricity_web/browser_helper.rb', line 61

def self.close_all_browser_instances
  Capybara.page.driver.browser.window_handles.each do |handle|
    page.driver.browser.switch_to.window(handle)
    page.driver.browser.close
  end
end

.close_current_browser_instance ⇒ Object 



72
73
74
75
 
# File 'lib/testcentricity_web/browser_helper.rb', line 72

def self.close_current_browser_instance
  Capybara.page.driver.browser.close
  Capybara.page.driver.browser.switch_to.window(Capybara.page.driver.browser.window_handles.last)
end

.close_named_browser_instance(name) ⇒ Object 



83
84
85
86
87
 
# File 'lib/testcentricity_web/browser_helper.rb', line 83

def self.close_named_browser_instance(name)
  Capybara.page.driver.browser.switch_to.window(Capybara.page.driver.find_window(name))
  Capybara.page.driver.browser.close
  Capybara.page.driver.browser.switch_to.window(Capybara.page.driver.browser.window_handles.last)
end

.close_old_browser_instance ⇒ Object 



77
78
79
80
81
 
# File 'lib/testcentricity_web/browser_helper.rb', line 77

def self.close_old_browser_instance
  Capybara.page.driver.browser.switch_to.window(Capybara.page.driver.browser.window_handles.first)
  Capybara.page.driver.browser.close
  Capybara.page.driver.browser.switch_to.window(Capybara.page.driver.browser.window_handles.last)
end

.delete_all_cookies ⇒ Object 



97
98
99
100
101
102
103
104
105
106
 
# File 'lib/testcentricity_web/browser_helper.rb', line 97

def self.delete_all_cookies
  if Capybara.current_driver == :selenium
    browser = Capybara.current_session.driver.browser
    if browser.respond_to?(:manage) && browser.manage.respond_to?(:delete_all_cookies)
      browser.manage.delete_all_cookies
    else
      raise 'Could not clear cookies.'
    end
  end
end

.maximize_browser ⇒ Object

Maximizes the selenium browser window.

Examples:

Browsers.maximize_browser


25
26
27
28
 
# File 'lib/testcentricity_web/browser_helper.rb', line 25

def self.maximize_browser
  window = Capybara.current_session.driver.browser.manage.window
  window.maximize
end

.mobile_device_agent(device) ⇒ Object 



116
117
118
119
120
121
122
 
# File 'lib/testcentricity_web/browser_helper.rb', line 116

def self.mobile_device_agent(device)
  device_name = device.gsub(/\s+/, '').downcase.to_sym
  device = get_devices[device_name]
  agent_string = device[:user_agent]
  raise "Device '#{device}' is not defined" unless agent_string
  agent_string
end

.mobile_device_name(device) ⇒ Object 



124
125
126
127
128
129
130
 
# File 'lib/testcentricity_web/browser_helper.rb', line 124

def self.mobile_device_name(device)
  device_name = device.gsub(/\s+/, '').downcase.to_sym
  device = get_devices[device_name]
  name = device[:name]
  raise "Device '#{device}' is not defined" unless name
  name
end

.navigate_back ⇒ Object

Emulates clicking the web browser's Back button. Navigates back by one page on the browser’s history.

Examples:

Browsers.navigate_back


44
45
46
 
# File 'lib/testcentricity_web/browser_helper.rb', line 44

def self.navigate_back
  Capybara.page.driver.browser.navigate.back
end

.navigate_forward ⇒ Object

Emulates clicking the web browser's Forward button. Navigates forward by one page on the browser’s history.

Examples:

Browsers.navigate_forward


53
54
55
 
# File 'lib/testcentricity_web/browser_helper.rb', line 53

def self.navigate_forward
  Capybara.page.driver.browser.navigate.forward
end

.num_browser_instances ⇒ Object 



68
69
70
 
# File 'lib/testcentricity_web/browser_helper.rb', line 68

def self.num_browser_instances
  Capybara.page.driver.browser.window_handles.count
end

.refresh_browser ⇒ Object

Refreshes the selenium browser.

Examples:

Browsers.refresh_browser


35
36
37
 
# File 'lib/testcentricity_web/browser_helper.rb', line 35

def self.refresh_browser
  Capybara.page.driver.browser.navigate.refresh
end

.set_browser_window_size(resolution) ⇒ Object

Sets the size of the browser window.

Examples:

Browsers.set_browser_window_size([1024, 768])

Parameters:

  • resolution (Array) —

    the desired [width, height]



14
15
16
17
18
 
# File 'lib/testcentricity_web/browser_helper.rb', line 14

def self.set_browser_window_size(resolution)
  resolution = resolution.split(',') if resolution.is_a?(String)
  window = Capybara.current_session.driver.browser.manage.window
  window.resize_to(resolution[0], resolution[1])
end

.set_device_orientation(orientation) ⇒ Object 



108
109
110
111
112
113
114
 
# File 'lib/testcentricity_web/browser_helper.rb', line 108

def self.set_device_orientation(orientation)
  if Environ.is_mobile? && !Environ.is_device?
    Browsers.set_browser_window_size(Browsers.browser_size(Environ.browser.to_s, orientation))
  else
    puts '***** Cannot change device orientation of desktop web browsers or remote devices *****'
  end
end

.suppress_js_alerts ⇒ Object 



89
90
91
 
# File 'lib/testcentricity_web/browser_helper.rb', line 89

def self.suppress_js_alerts
  Capybara.page.execute_script('window.alert = function() {}')
end

.suppress_js_leave_page_modal ⇒ Object 



93
94
95
 
# File 'lib/testcentricity_web/browser_helper.rb', line 93

def self.suppress_js_leave_page_modal
  Capybara.page.execute_script('window.onbeforeunload = null')
end

.switch_to_new_browser_instance ⇒ Object 



57
58
59
 
# File 'lib/testcentricity_web/browser_helper.rb', line 57

def self.switch_to_new_browser_instance
  Capybara.page.driver.browser.switch_to.window(Capybara.page.driver.browser.window_handles.last)
end