Class: TestCentricity::PageSection
- Includes:
- Capybara::DSL, Capybara::Node::Matchers, Test::Unit::Assertions
- Defined in:
- lib/testcentricity_web/page_sections_helper.rb
Instance Attribute Summary collapse
-
#context ⇒ Object
readonly
Returns the value of attribute context.
-
#locator ⇒ Object
readonly
Returns the value of attribute locator.
-
#parent ⇒ Object
Returns the value of attribute parent.
Class Method Summary collapse
-
.button(element_name, locator) ⇒ Object
Declare and instantiate a button UI Element for this page section.
-
.checkbox(element_name, locator, proxy = nil) ⇒ Object
Declare and instantiate a checkbox UI Element for this page section.
-
.element(element_name, locator) ⇒ Object
Declare and instantiate a generic UI Element for this page section.
-
.filefield(element_name, locator) ⇒ Object
Declare and instantiate a File Field UI Element for this page section.
-
.image(element_name, locator) ⇒ Object
Declare and instantiate an image UI Element for this page section.
-
.label(element_name, locator) ⇒ Object
Declare and instantiate a label UI Element for this page section.
-
.link(element_name, locator) ⇒ Object
Declare and instantiate a link UI Element for this page section.
-
.radio(element_name, locator, proxy = nil) ⇒ Object
Declare and instantiate a radio button UI Element for this page section.
-
.section(section_name, class_name, locator = nil) ⇒ Object
Instantiate a PageSection object within this PageSection object.
-
.selectlist(element_name, locator) ⇒ Object
Declare and instantiate a select list UI Element for this page section.
-
.table(element_name, locator) ⇒ Object
Declare and instantiate a table UI Element for this page section.
-
.textfield(element_name, locator) ⇒ Object
Declare and instantiate a text field UI Element for this page section.
-
.trait(trait_name, &block) ⇒ Object
Define a trait for this page section.
Instance Method Summary collapse
-
#exists? ⇒ Boolean
Does Section object exists?.
- #get_attribute(attrib) ⇒ Object
- #get_locator ⇒ Object
- #get_native_attribute(attrib) ⇒ Object
-
#hidden? ⇒ Boolean
Is Section object hidden (not visible)?.
-
#initialize(parent, locator, context) ⇒ PageSection
constructor
A new instance of PageSection.
-
#populate_data_fields(data) ⇒ Object
Populate the specified UI elements in this Section object with the associated data from a Hash passed as an argument.
- #set_parent(parent) ⇒ Object
- #verify_ui_states(ui_states) ⇒ Object
-
#visible? ⇒ Boolean
Is Section object visible?.
-
#wait_until_exists(seconds = nil) ⇒ Object
Wait until the Section object exists, or until the specified wait time has expired.
-
#wait_until_gone(seconds = nil) ⇒ Object
Wait until the Section object no longer exists, or until the specified wait time has expired.
Constructor Details
#initialize(parent, locator, context) ⇒ PageSection
Returns a new instance of PageSection.
12 13 14 15 16 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 12 def initialize(parent, locator, context) @parent = parent @locator = locator @context = context end |
Instance Attribute Details
#context ⇒ Object (readonly)
Returns the value of attribute context.
9 10 11 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 9 def context @context end |
#locator ⇒ Object (readonly)
Returns the value of attribute locator.
9 10 11 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 9 def locator @locator end |
#parent ⇒ Object
Returns the value of attribute parent.
10 11 12 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 10 def parent @parent end |
Class Method Details
.button(element_name, locator) ⇒ Object
Declare and instantiate a button UI Element for this page section.
50 51 52 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 50 def self.(element_name, locator) class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Button.new(self, "#{locator}", :section);end)) end |
.checkbox(element_name, locator, proxy = nil) ⇒ Object
Declare and instantiate a checkbox UI Element for this page section.
75 76 77 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 75 def self.checkbox(element_name, locator, proxy = nil) class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::CheckBox.new(self, "#{locator}", :section, #{proxy});end)) end |
.element(element_name, locator) ⇒ Object
Declare and instantiate a generic UI Element for this page section.
38 39 40 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 38 def self.element(element_name, locator) class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :section);end)) end |
.filefield(element_name, locator) ⇒ Object
Declare and instantiate a File Field UI Element for this page section.
158 159 160 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 158 def self.filefield(element_name, locator) class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::FileField.new(self, "#{locator}", :section);end)) end |
.image(element_name, locator) ⇒ Object
Declare and instantiate an image UI Element for this page section.
147 148 149 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 147 def self.image(element_name, locator) class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Image.new(self, "#{locator}", :section);end)) end |
.label(element_name, locator) ⇒ Object
Declare and instantiate a label UI Element for this page section.
100 101 102 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 100 def self.label(element_name, locator) class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Label.new(self, "#{locator}", :section);end)) end |
.link(element_name, locator) ⇒ Object
Declare and instantiate a link UI Element for this page section.
112 113 114 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 112 def self.link(element_name, locator) class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Link.new(self, "#{locator}", :section);end)) end |
.radio(element_name, locator, proxy = nil) ⇒ Object
Declare and instantiate a radio button UI Element for this page section.
88 89 90 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 88 def self.radio(element_name, locator, proxy = nil) class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Radio.new(self, "#{locator}", :section, #{proxy});end)) end |
.section(section_name, class_name, locator = nil) ⇒ Object
Instantiate a PageSection object within this PageSection object.
169 170 171 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 169 def self.section(section_name, class_name, locator = nil) class_eval(%Q(def #{section_name.to_s};@#{section_name.to_s} ||= #{class_name.to_s}.new(self, "#{locator}", :section);end)) end |
.selectlist(element_name, locator) ⇒ Object
Declare and instantiate a select list UI Element for this page section.
135 136 137 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 135 def self.selectlist(element_name, locator) class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::SelectList.new(self, "#{locator}", :section);end)) end |
.table(element_name, locator) ⇒ Object
Declare and instantiate a table UI Element for this page section.
123 124 125 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 123 def self.table(element_name, locator) class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Table.new(self, "#{locator}", :section);end)) end |
.textfield(element_name, locator) ⇒ Object
Declare and instantiate a text field UI Element for this page section.
62 63 64 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 62 def self.textfield(element_name, locator) class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::TextField.new(self, "#{locator}", :section);end)) end |
.trait(trait_name, &block) ⇒ Object
Define a trait for this page section.
26 27 28 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 26 def self.trait(trait_name, &block) define_method(trait_name.to_s, &block) end |
Instance Method Details
#exists? ⇒ Boolean
Does Section object exists?
188 189 190 191 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 188 def exists? section, _ = find_section section != nil end |
#get_attribute(attrib) ⇒ Object
350 351 352 353 354 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 350 def get_attribute(attrib) section, _ = find_section raise "Section #{locator} not found" unless section section[attrib] end |
#get_locator ⇒ Object
173 174 175 176 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 173 def get_locator (@locator.empty? && defined?(section_locator)) ? locator = section_locator : locator = @locator (@context == :section && !@parent.nil? && !@parent.get_locator.nil?) ? "#{@parent.get_locator}|#{locator}" : locator end |
#get_native_attribute(attrib) ⇒ Object
356 357 358 359 360 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 356 def get_native_attribute(attrib) section, _ = find_section raise "Section #{locator} not found" unless section section.native.attribute(attrib) end |
#hidden? ⇒ Boolean
Is Section object hidden (not visible)?
225 226 227 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 225 def hidden? not visible? end |
#populate_data_fields(data) ⇒ Object
Populate the specified UI elements in this Section object with the associated data from a Hash passed as an argument. Data values must be in the form of a String for textfield and select list controls. For checkbox and radio buttons, data must either be a Boolean or a String that evaluates to a Boolean value (Yes, No, 1, 0, true, false)
323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 323 def populate_data_fields(data) data.each do | data_field, data_param | unless data_param.blank? # make sure the intended UI target element exists before trying to set its value data_field.wait_until_exists(2) if data_param == '!DELETE' data_field.set('') else case data_field.get_object_type when :checkbox (data_field.get_siebel_object_type == 'JCheckBox') ? data_field.set_siebel_checkbox_state(data_param.to_bool) : data_field.set_checkbox_state(data_param.to_bool) when :selectlist (data_field.get_siebel_object_type == 'JComboBox') ? data_field.set("#{data_param}\t") : data_field.choose_option(data_param) when :radio data_field.set_selected_state(data_param.to_bool) when :textfield data_field.set("#{data_param}\t") end end end end end |
#set_parent(parent) ⇒ Object
178 179 180 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 178 def set_parent(parent) @parent = parent end |
#verify_ui_states(ui_states) ⇒ Object
257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 257 def verify_ui_states(ui_states) ui_states.each do | ui_object, object_states | object_states.each do | property, state | case property when :exists actual = ui_object.exists? when :enabled actual = ui_object.enabled? when :disabled actual = ui_object.disabled? when :visible actual = ui_object.visible? when :hidden actual = ui_object.hidden? when :readonly actual = ui_object.read_only? when :checked actual = ui_object.checked? when :selected if ui_object.get_object_type == :selectlist actual = ui_object.get_selected_option else actual = ui_object.selected? end when :value actual = ui_object.get_value when :maxlength actual = ui_object.get_max_length when :placeholder actual = ui_object.get_placeholder when :options actual = ui_object. when :column_headers actual = ui_object.get_header_columns when :siebel_options actual = ui_object. else if property.to_s.start_with? ('cell_') cell = property.to_s.gsub('cell_', '') cell = cell.split('_') actual = ui_object.get_table_cell(cell[0].to_i, cell[1].to_i) end end ExceptionQueue.enqueue_assert_equal(state, actual, "Expected #{ui_object.get_locator} #{property.to_s} property") end end ExceptionQueue.post_exceptions end |
#visible? ⇒ Boolean
Is Section object visible?
199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 199 def visible? section, type = find_section exists = section invisible = false if type == :css Capybara.using_wait_time 0.1 do # is section itself hidden with .ui-helper-hidden class? self_hidden = page.has_css?("#{@locator}.ui-helper-hidden") # is parent of section hidden, thus hiding the section? parent_hidden = page.has_css?(".ui-helper-hidden > #{@locator}") # is grandparent of section, or any other ancestor, hidden? other_ancestor_hidden = page.has_css?(".ui-helper-hidden * #{@locator}") # if any of the above conditions are true, then section is invisible invisible = self_hidden || parent_hidden || other_ancestor_hidden end end # the section is visible if it exists and it is not invisible (exists && !invisible) ? true : false end |
#wait_until_exists(seconds = nil) ⇒ Object
Wait until the Section object exists, or until the specified wait time has expired.
235 236 237 238 239 240 241 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 235 def wait_until_exists(seconds = nil) timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds wait = Selenium::WebDriver::Wait.new(timeout: timeout) wait.until { exists? } rescue raise "Could not find section #{get_locator} after #{timeout} seconds" unless exists? end |
#wait_until_gone(seconds = nil) ⇒ Object
Wait until the Section object no longer exists, or until the specified wait time has expired.
249 250 251 252 253 254 255 |
# File 'lib/testcentricity_web/page_sections_helper.rb', line 249 def wait_until_gone(seconds = nil) timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds wait = Selenium::WebDriver::Wait.new(timeout: timeout) wait.until { !exists? } rescue raise "Section #{get_locator} remained visible after #{timeout} seconds" if exists? end |