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 



146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
 
# File 'lib/testcentricity_web/browser_helper.rb', line 146

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
      Environ.device_orientation = orientation
      size = if orientation.downcase.to_sym == default_orientation
               [width, height]
             else
               [height, width]
             end
    else
      Environ.device_orientation = device[:default_orientation]
      size = [width, height]
    end
  else
    size = [1650, 1000]
  end
  size
end

.close_all_browser_instances ⇒ Object 



73
74
75
76
77
78
 
# File 'lib/testcentricity_web/browser_helper.rb', line 73

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 



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

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 



95
96
97
98
99
 
# File 'lib/testcentricity_web/browser_helper.rb', line 95

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 



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

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 



109
110
111
112
113
114
115
116
117
118
 
# File 'lib/testcentricity_web/browser_helper.rb', line 109

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


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

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

.mobile_device_agent(device) ⇒ Object 



128
129
130
131
132
133
134
 
# File 'lib/testcentricity_web/browser_helper.rb', line 128

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 



136
137
138
139
140
141
142
143
144
 
# File 'lib/testcentricity_web/browser_helper.rb', line 136

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
  Environ.device_os = device[:os]
  Environ.device_type = device[:type]
  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


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

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


65
66
67
 
# File 'lib/testcentricity_web/browser_helper.rb', line 65

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

.num_browser_instances ⇒ Object 



80
81
82
 
# File 'lib/testcentricity_web/browser_helper.rb', line 80

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

.refresh_browser ⇒ Object

Refreshes the selenium browser.

Examples:

Browsers.refresh_browser


47
48
49
 
# File 'lib/testcentricity_web/browser_helper.rb', line 47

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

.set_browser_window_position(x, y) ⇒ Object

Sets the position of the browser window.

Examples:

Browsers.set_browser_window_position([100, 300])

Parameters:

  • x (Integer) —

    the desired x coordinate

  • y (Integer) —

    the desired y coordinate



37
38
39
40
 
# File 'lib/testcentricity_web/browser_helper.rb', line 37

def self.set_browser_window_position(x, y)
  window = Capybara.current_session.driver.browser.manage.window
  window.move_to(x, y)
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
19
 
# 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])
  Environ.browser_size = [resolution[0].to_i, resolution[1].to_i]
end

.set_device_orientation(orientation) ⇒ Object 



120
121
122
123
124
125
126
 
# File 'lib/testcentricity_web/browser_helper.rb', line 120

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 



101
102
103
 
# File 'lib/testcentricity_web/browser_helper.rb', line 101

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

.suppress_js_leave_page_modal ⇒ Object 



105
106
107
 
# File 'lib/testcentricity_web/browser_helper.rb', line 105

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

.switch_to_new_browser_instance ⇒ Object 



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

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