Class: TestCentricity::UIElement
- Includes:
- Capybara::DSL, Test::Unit::Assertions
- Defined in:
- lib/testcentricity_web/web_elements/ui_elements_helper.rb
Direct Known Subclasses
Button, CheckBox, FileField, Image, Label, Link, List, Media, Radio, SelectList, Table, TextField
Constant Summary collapse
- XPATH_SELECTORS =
['//', '[@', '[contains(']
- CSS_SELECTORS =
['#', ':nth-child(', ':first-child', ':last-child', ':nth-of-type(', ':first-of-type', ':last-of-type', '^=', '$=', '*=', ':contains(']
Instance Attribute Summary collapse
-
#alt_locator ⇒ Object
Returns the value of attribute alt_locator.
-
#context ⇒ Object
readonly
Returns the value of attribute context.
-
#locator ⇒ Object
readonly
Returns the value of attribute locator.
-
#locator_type ⇒ Object
Returns the value of attribute locator_type.
-
#name ⇒ Object
readonly
Returns the value of attribute name.
-
#original_style ⇒ Object
Returns the value of attribute original_style.
-
#parent ⇒ Object
readonly
Returns the value of attribute parent.
-
#type ⇒ Object
readonly
Returns the value of attribute type.
Instance Method Summary collapse
-
#aria_autocomplete ⇒ Integer
Return state of UI object's aria-autocomplete property.
-
#aria_busy? ⇒ Boolean
Return state of UI object's aria-busy property.
-
#aria_checked? ⇒ Boolean
Return state of UI object's aria-checked property.
-
#aria_colcount ⇒ Integer
Return state of UI object's aria-colcount property.
-
#aria_controls ⇒ Integer
Return state of UI object's aria-controls property.
-
#aria_describedby ⇒ String
Return state of UI object's aria-describedby property.
-
#aria_disabled? ⇒ Boolean
Return state of UI object's aria-disabled property.
-
#aria_expanded? ⇒ Boolean
Return state of UI object's aria-expanded property.
-
#aria_haspopup? ⇒ Boolean
Return state of UI object's aria-haspopup property.
-
#aria_hidden? ⇒ Boolean
Return state of UI object's aria-hidden property.
-
#aria_invalid? ⇒ Boolean
Return state of UI object's aria-invalid property.
-
#aria_keyshortcuts ⇒ Integer
Return state of UI object's aria-keyshortcuts property.
-
#aria_label ⇒ String
Return state of UI object's aria-label property.
-
#aria_labelledby ⇒ String
Return state of UI object's aria-labelledby property.
-
#aria_live ⇒ String
Return state of UI object's aria-live property.
-
#aria_modal? ⇒ Boolean
Return state of UI object's aria-modal property.
-
#aria_multiline? ⇒ Boolean
Return state of UI object's aria-multiline property.
-
#aria_multiselectable? ⇒ Boolean
Return state of UI object's aria-multiselectable property.
-
#aria_orientation ⇒ Integer
Return state of UI object's aria-orientation property.
-
#aria_pressed? ⇒ Boolean
Return state of UI object's aria-pressed property.
-
#aria_readonly? ⇒ Boolean
Return state of UI object's aria-readonly property.
-
#aria_required? ⇒ Boolean
Return state of UI object's aria-required property.
-
#aria_roledescription ⇒ Integer
Return state of UI object's aria-roledescription property.
-
#aria_rowcount ⇒ Integer
Return state of UI object's aria-rowcount property.
-
#aria_selected? ⇒ Boolean
Return state of UI object's aria-selected property.
-
#aria_sort ⇒ String
Return state of UI object's aria-sort property.
-
#aria_valuemax ⇒ Integer
Return state of UI object's aria-valuemax property.
-
#aria_valuemin ⇒ Integer
Return state of UI object's aria-valuemin property.
-
#aria_valuenow ⇒ Integer
Return state of UI object's aria-valuenow property.
-
#aria_valuetext ⇒ Integer
Return state of UI object's aria-valuetext property.
- #clear_alt_locator ⇒ Object
-
#click ⇒ Object
Click on an object.
-
#click_at(x, y) ⇒ Object
Click at a specific location within an object.
-
#content_editable? ⇒ Boolean
Return state of UI object's contenteditable property.
-
#count(visible = true) ⇒ Object
Return the number of occurrences of an object with an ambiguous locator that evaluates to multiple UI elements.
-
#disabled? ⇒ Boolean
Is UI object disabled (not enabled)?.
-
#displayed? ⇒ Boolean
Is UI object displayed in browser window?.
-
#double_click ⇒ Object
Double-click on an object.
- #drag_and_drop(target, right_offset = nil, down_offset = nil) ⇒ Object
- #drag_by(right_offset, down_offset) ⇒ Object
-
#enabled? ⇒ Boolean
Is UI object enabled?.
-
#exists?(visible = true) ⇒ Boolean
Does UI object exists?.
- #find_element(visible = true) ⇒ Object
-
#focused? ⇒ Boolean
Does UI object have the current focus?.
- #get_attribute(attrib) ⇒ Object
- #get_locator ⇒ Object
- #get_locator_type ⇒ Object
- #get_name ⇒ Object
- #get_native_attribute(attrib) ⇒ Object
- #get_object_type ⇒ Object
- #get_value(visible = true) ⇒ Object (also: #get_caption)
-
#height ⇒ Integer
Return height of object.
-
#hidden? ⇒ Boolean
Is UI object hidden (not visible)?.
-
#highlight(duration = 1) ⇒ Object
Highlight an object with a 3 pixel wide, red dashed border for the specified wait time.
-
#hover(visible = true) ⇒ Object
Hover the cursor over an object.
-
#hover_at(x, y, visible = true) ⇒ Object
Hover at a specific location within an object.
-
#initialize(name, parent, locator, context) ⇒ UIElement
constructor
A new instance of UIElement.
-
#inspect ⇒ String
Return a human readable representation of the UI element.
-
#obscured? ⇒ Boolean
Is UI object obscured (not currently in viewport and not clickable)?.
-
#right_click ⇒ Object
Right-click on an object.
-
#role ⇒ String
Return state of UI object's role property.
-
#scroll_to(position) ⇒ Object
Scroll the object to its top, middle, or bottom.
-
#send_keys(*keys) ⇒ Object
Send keystrokes to this object.
- #set(value) ⇒ Object
- #set_alt_locator(temp_locator) ⇒ Object
- #set_locator_type(locator = nil) ⇒ Object
-
#style ⇒ String
Return UI object's style property.
-
#tabindex ⇒ String
Return state of UI object's tabindex property.
-
#title ⇒ String
Return UI object's title property.
-
#unhighlight ⇒ Object
Restore a highlighted object's original style.
- #verify_value(expected, enqueue = false) ⇒ Object (also: #verify_caption)
-
#visible? ⇒ Boolean
Is UI object visible?.
-
#wait_until_exists(seconds = nil, post_exception = true) ⇒ Object
Wait until the object exists, or until the specified wait time has expired.
-
#wait_until_gone(seconds = nil, post_exception = true) ⇒ Object
Wait until the object no longer exists, or until the specified wait time has expired.
-
#wait_until_hidden(seconds = nil, post_exception = true) ⇒ Object
Wait until the object is hidden, or until the specified wait time has expired.
-
#wait_until_value_changes(seconds = nil, post_exception = true) ⇒ Object
Wait until the object's value changes to a different value, or until the specified wait time has expired.
-
#wait_until_value_is(value, seconds = nil, post_exception = true) ⇒ Object
Wait until the object's value equals the specified value, or until the specified wait time has expired.
-
#wait_until_visible(seconds = nil, post_exception = true) ⇒ Object
Wait until the object is visible, or until the specified wait time has expired.
-
#width ⇒ Integer
Return width of object.
-
#x ⇒ Integer
Return x coordinate of object's location.
-
#y ⇒ Integer
Return y coordinate of object's location.
Constructor Details
#initialize(name, parent, locator, context) ⇒ UIElement
Returns a new instance of UIElement.
51 52 53 54 55 56 57 58 59 60 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 51 def initialize(name, parent, locator, context) @name = name @parent = parent @locator = locator @context = context @type = nil @alt_locator = nil @original_style = nil set_locator_type end |
Instance Attribute Details
#alt_locator ⇒ Object
Returns the value of attribute alt_locator.
46 47 48 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 46 def alt_locator @alt_locator end |
#context ⇒ Object (readonly)
Returns the value of attribute context.
45 46 47 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 45 def context @context end |
#locator ⇒ Object (readonly)
Returns the value of attribute locator.
45 46 47 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 45 def locator @locator end |
#locator_type ⇒ Object
Returns the value of attribute locator_type.
46 47 48 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 46 def locator_type @locator_type end |
#name ⇒ Object (readonly)
Returns the value of attribute name.
45 46 47 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 45 def name @name end |
#original_style ⇒ Object
Returns the value of attribute original_style.
46 47 48 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 46 def original_style @original_style end |
#parent ⇒ Object (readonly)
Returns the value of attribute parent.
45 46 47 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 45 def parent @parent end |
#type ⇒ Object (readonly)
Returns the value of attribute type.
45 46 47 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 45 def type @type end |
Instance Method Details
#aria_autocomplete ⇒ Integer
Return state of UI object's aria-autocomplete property
806 807 808 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 806 def aria_autocomplete get_attribute('aria-autocomplete') end |
#aria_busy? ⇒ Boolean
Return state of UI object's aria-busy property
936 937 938 939 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 936 def aria_busy? state = get_attribute('aria-busy') state.boolean? ? state : state == 'true' end |
#aria_checked? ⇒ Boolean
Return state of UI object's aria-checked property
892 893 894 895 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 892 def aria_checked? state = get_attribute('aria-checked') state.boolean? ? state : state == 'true' end |
#aria_colcount ⇒ Integer
Return state of UI object's aria-colcount property
726 727 728 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 726 def aria_colcount get_attribute('aria-colcount') end |
#aria_controls ⇒ Integer
Return state of UI object's aria-controls property
816 817 818 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 816 def aria_controls get_attribute('aria-controls') end |
#aria_describedby ⇒ String
Return state of UI object's aria-describedby property
686 687 688 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 686 def aria_describedby get_attribute('aria-describedby') end |
#aria_disabled? ⇒ Boolean
Return state of UI object's aria-disabled property
826 827 828 829 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 826 def aria_disabled? state = get_attribute('aria-disabled') state.boolean? ? state : state == 'true' end |
#aria_expanded? ⇒ Boolean
Return state of UI object's aria-expanded property
859 860 861 862 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 859 def state = get_attribute('aria-expanded') state.boolean? ? state : state == 'true' end |
#aria_haspopup? ⇒ Boolean
Return state of UI object's aria-haspopup property
903 904 905 906 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 903 def aria_haspopup? state = get_attribute('aria-haspopup') state.boolean? ? state : state == 'true' end |
#aria_hidden? ⇒ Boolean
Return state of UI object's aria-hidden property
848 849 850 851 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 848 def aria_hidden? state = get_attribute('aria-hidden') state.boolean? ? state : state == 'true' end |
#aria_invalid? ⇒ Boolean
Return state of UI object's aria-invalid property
881 882 883 884 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 881 def aria_invalid? state = get_attribute('aria-invalid') state.boolean? ? state : state == 'true' end |
#aria_keyshortcuts ⇒ Integer
Return state of UI object's aria-keyshortcuts property
786 787 788 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 786 def aria_keyshortcuts get_attribute('aria-keyshortcuts') end |
#aria_label ⇒ String
Return state of UI object's aria-label property
666 667 668 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 666 def aria_label get_attribute('aria-label') end |
#aria_labelledby ⇒ String
Return state of UI object's aria-labelledby property
676 677 678 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 676 def aria_labelledby get_attribute('aria-labelledby') end |
#aria_live ⇒ String
Return state of UI object's aria-live property
696 697 698 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 696 def aria_live get_attribute('aria-live') end |
#aria_modal? ⇒ Boolean
Return state of UI object's aria-modal property
947 948 949 950 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 947 def aria_modal? state = get_attribute('aria-modal') state.boolean? ? state : state == 'true' end |
#aria_multiline? ⇒ Boolean
Return state of UI object's aria-multiline property
958 959 960 961 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 958 def aria_multiline? state = get_attribute('aria-multiline') state.boolean? ? state : state == 'true' end |
#aria_multiselectable? ⇒ Boolean
Return state of UI object's aria-multiselectable property
969 970 971 972 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 969 def aria_multiselectable? state = get_attribute('aria-multiselectable') state.boolean? ? state : state == 'true' end |
#aria_orientation ⇒ Integer
Return state of UI object's aria-orientation property
776 777 778 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 776 def aria_orientation get_attribute('aria-orientation') end |
#aria_pressed? ⇒ Boolean
Return state of UI object's aria-pressed property
914 915 916 917 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 914 def aria_pressed? state = get_attribute('aria-pressed') state.boolean? ? state : state == 'true' end |
#aria_readonly? ⇒ Boolean
Return state of UI object's aria-readonly property
925 926 927 928 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 925 def aria_readonly? state = get_attribute('aria-readonly') state.boolean? ? state : state == 'true' end |
#aria_required? ⇒ Boolean
Return state of UI object's aria-required property
870 871 872 873 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 870 def aria_required? state = get_attribute('aria-required') state.boolean? ? state : state == 'true' end |
#aria_roledescription ⇒ Integer
Return state of UI object's aria-roledescription property
796 797 798 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 796 def aria_roledescription get_attribute('aria-roledescription') end |
#aria_rowcount ⇒ Integer
Return state of UI object's aria-rowcount property
716 717 718 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 716 def aria_rowcount get_attribute('aria-rowcount') end |
#aria_selected? ⇒ Boolean
Return state of UI object's aria-selected property
837 838 839 840 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 837 def aria_selected? state = get_attribute('aria-selected') state.boolean? ? state : state == 'true' end |
#aria_sort ⇒ String
Return state of UI object's aria-sort property
706 707 708 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 706 def aria_sort get_attribute('aria-sort') end |
#aria_valuemax ⇒ Integer
Return state of UI object's aria-valuemax property
736 737 738 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 736 def aria_valuemax get_attribute('aria-valuemax') end |
#aria_valuemin ⇒ Integer
Return state of UI object's aria-valuemin property
746 747 748 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 746 def aria_valuemin get_attribute('aria-valuemin') end |
#aria_valuenow ⇒ Integer
Return state of UI object's aria-valuenow property
756 757 758 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 756 def aria_valuenow get_attribute('aria-valuenow') end |
#aria_valuetext ⇒ Integer
Return state of UI object's aria-valuetext property
766 767 768 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 766 def aria_valuetext get_attribute('aria-valuetext') end |
#clear_alt_locator ⇒ Object
107 108 109 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 107 def clear_alt_locator @alt_locator = nil end |
#click ⇒ Object
Click on an object
116 117 118 119 120 121 122 123 124 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 116 def click obj, type = find_element object_not_found_exception(obj, type) begin obj.click rescue StandardError obj.click_at(10, 10) end end |
#click_at(x, y) ⇒ Object
Click at a specific location within an object
155 156 157 158 159 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 155 def click_at(x, y) obj, = find_element raise "UI #{} not found" unless obj obj.click_at(x, y) end |
#content_editable? ⇒ Boolean
Return state of UI object's contenteditable property
980 981 982 983 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 980 def content_editable? state = get_attribute('contenteditable') state.boolean? ? state : state == 'true' end |
#count(visible = true) ⇒ Object
Return the number of occurrences of an object with an ambiguous locator that evaluates to multiple UI elements.
432 433 434 435 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 432 def count(visible = true) obj_locator = @alt_locator.nil? ? @locator : @alt_locator page.all(@locator_type, obj_locator, wait: 0.01, visible: visible, minimum: 0).count end |
#disabled? ⇒ Boolean
Is UI object disabled (not enabled)?
260 261 262 263 264 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 260 def disabled? obj, type = find_element object_not_found_exception(obj, type) obj.disabled? end |
#displayed? ⇒ Boolean
Is UI object displayed in browser window?
501 502 503 504 505 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 501 def displayed? obj, type = find_element(visible = false) object_not_found_exception(obj, type) obj.displayed? end |
#double_click ⇒ Object
Double-click on an object
131 132 133 134 135 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 131 def double_click obj, type = find_element object_not_found_exception(obj, type) page.driver.browser.action.double_click(obj.native).perform end |
#drag_and_drop(target, right_offset = nil, down_offset = nil) ⇒ Object
573 574 575 576 577 578 579 580 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 573 def drag_and_drop(target, right_offset = nil, down_offset = nil) source, type = find_element object_not_found_exception(source, type) page.driver.browser.action.click_and_hold(source.native).perform sleep(1) target_drop, = target.find_element page.driver.browser.action.move_to(target_drop.native, right_offset.to_i, down_offset.to_i).release.perform end |
#drag_by(right_offset, down_offset) ⇒ Object
565 566 567 568 569 570 571 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 565 def drag_by(right_offset, down_offset) obj, type = find_element object_not_found_exception(obj, type) page.driver.browser.action.click_and_hold(obj.native).perform sleep(1) obj.drag_by(right_offset, down_offset) end |
#enabled? ⇒ Boolean
Is UI object enabled?
250 251 252 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 250 def enabled? !disabled? end |
#exists?(visible = true) ⇒ Boolean
Does UI object exists?
197 198 199 200 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 197 def exists?(visible = true) obj, = find_object(visible) obj != nil end |
#find_element(visible = true) ⇒ Object
997 998 999 1000 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 997 def find_element(visible = true) wait = Selenium::WebDriver::Wait.new(timeout: Capybara.default_max_wait_time) wait.until { find_object(visible) } end |
#focused? ⇒ Boolean
Does UI object have the current focus?
284 285 286 287 288 289 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 284 def focused? obj, type = find_element(visible = :all) object_not_found_exception(obj, type) focused_obj = page.driver.browser.switch_to.active_element focused_obj == obj.native end |
#get_attribute(attrib) ⇒ Object
985 986 987 988 989 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 985 def get_attribute(attrib) obj, type = find_element(visible = false) object_not_found_exception(obj, type) obj[attrib] end |
#get_locator ⇒ Object
95 96 97 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 95 def get_locator @locator end |
#get_locator_type ⇒ Object
77 78 79 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 77 def get_locator_type @locator_type end |
#get_name ⇒ Object
99 100 101 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 99 def get_name @name end |
#get_native_attribute(attrib) ⇒ Object
991 992 993 994 995 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 991 def get_native_attribute(attrib) obj, type = find_element(visible = false) object_not_found_exception(obj, type) obj.native.attribute(attrib) end |
#get_object_type ⇒ Object
81 82 83 84 85 86 87 88 89 90 91 92 93 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 81 def get_object_type if @type @type else obj, type = find_element object_not_found_exception(obj, type) if obj.tag_name obj.tag_name elsif obj.native.attribute('type') obj.native.attribute('type') end end end |
#get_value(visible = true) ⇒ Object Also known as:
507 508 509 510 511 512 513 514 515 516 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 507 def get_value(visible = true) obj, type = find_element(visible) object_not_found_exception(obj, type) case obj.tag_name.downcase when 'input', 'select', 'textarea' obj.value else obj.text end end |
#height ⇒ Integer
Return height of object.
455 456 457 458 459 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 455 def height obj, type = find_element(visible = false) object_not_found_exception(obj, type) obj.get_height end |
#hidden? ⇒ Boolean
Is UI object hidden (not visible)?
240 241 242 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 240 def hidden? !visible? end |
#highlight(duration = 1) ⇒ Object
Highlight an object with a 3 pixel wide, red dashed border for the specified wait time. If wait time is zero, then the highlight will remain until the page is refreshed
589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 589 def highlight(duration = 1) obj, type = find_element object_not_found_exception(obj, type) # store original style so it can be reset later @original_style = obj.native.attribute('style') # style element with red border page.execute_script( 'arguments[0].setAttribute(arguments[1], arguments[2])', obj, 'style', 'border: 3px solid red; border-style: dashed;' ) # keep element highlighted for duration and then revert to original style if duration.positive? sleep duration page.execute_script( 'arguments[0].setAttribute(arguments[1], arguments[2])', obj, 'style', @original_style ) end end |
#hover(visible = true) ⇒ Object
Hover the cursor over an object
540 541 542 543 544 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 540 def hover(visible = true) obj, type = find_element(visible) object_not_found_exception(obj, type) obj.hover end |
#hover_at(x, y, visible = true) ⇒ Object
Hover at a specific location within an object
559 560 561 562 563 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 559 def hover_at(x, y, visible = true) obj, = find_element(visible) raise "UI #{} not found" unless obj obj.hover_at(x, y) end |
#inspect ⇒ String
Return a human readable representation of the UI element
297 298 299 300 301 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 297 def inspect obj, type = find_element object_not_found_exception(obj, type) obj.inspect end |
#obscured? ⇒ Boolean
Is UI object obscured (not currently in viewport and not clickable)?
272 273 274 275 276 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 272 def obscured? obj, type = find_element object_not_found_exception(obj, type) obj.obscured? end |
#right_click ⇒ Object
Right-click on an object
142 143 144 145 146 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 142 def right_click obj, type = find_element object_not_found_exception(obj, type) page.driver.browser.action.context_click(obj.native).perform end |
#role ⇒ String
Return state of UI object's role property
646 647 648 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 646 def role get_attribute('role') end |
#scroll_to(position) ⇒ Object
Scroll the object to its top, middle, or bottom
167 168 169 170 171 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 167 def scroll_to(position) obj, type = find_element object_not_found_exception(obj, type) obj.scroll_to(position) end |
#send_keys(*keys) ⇒ Object
Send keystrokes to this object.
185 186 187 188 189 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 185 def send_keys(*keys) obj, type = find_element object_not_found_exception(obj, type) obj.send_keys(*keys) end |
#set(value) ⇒ Object
173 174 175 176 177 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 173 def set(value) obj, type = find_element object_not_found_exception(obj, type) obj.set(value) end |
#set_alt_locator(temp_locator) ⇒ Object
103 104 105 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 103 def set_alt_locator(temp_locator) @alt_locator = temp_locator end |
#set_locator_type(locator = nil) ⇒ Object
62 63 64 65 66 67 68 69 70 71 72 73 74 75 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 62 def set_locator_type(locator = nil) locator = @locator if locator.nil? is_xpath = XPATH_SELECTORS.any? { |selector| locator.include?(selector) } is_css = CSS_SELECTORS.any? { |selector| locator.include?(selector) } @locator_type = if is_xpath && !is_css :xpath elsif is_css && !is_xpath :css elsif !is_css && !is_xpath :css else :css end end |
#style ⇒ String
Return UI object's style property
636 637 638 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 636 def style get_attribute('style') end |
#tabindex ⇒ String
Return state of UI object's tabindex property
656 657 658 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 656 def tabindex get_attribute('tabindex') end |
#title ⇒ String
Return UI object's title property
491 492 493 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 491 def title get_attribute(:title) end |
#unhighlight ⇒ Object
Restore a highlighted object's original style
618 619 620 621 622 623 624 625 626 627 628 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 618 def unhighlight obj, type = find_element object_not_found_exception(obj, type) return if @original_style.nil? page.execute_script( 'arguments[0].setAttribute(arguments[1], arguments[2])', obj, 'style', @original_style ) end |
#verify_value(expected, enqueue = false) ⇒ Object Also known as:
520 521 522 523 524 525 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 520 def verify_value(expected, enqueue = false) actual = get_value enqueue ? ExceptionQueue.enqueue_assert_equal(expected.strip, actual.strip, "Expected UI #{}") : assert_equal(expected.strip, actual.strip, "Expected UI #{} to display '#{expected}' but found '#{actual}'") end |
#visible? ⇒ Boolean
Is UI object visible?
208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 208 def visible? obj, type = find_element exists = obj invisible = false if type == :css Capybara.using_wait_time 0.1 do # is object itself hidden with .ui-helper-hidden class? self_hidden = page.has_css?("#{@locator}.ui-helper-hidden") # is parent of object hidden, thus hiding the object? parent_hidden = page.has_css?(".ui-helper-hidden > #{@locator}") # is grandparent of object, or any other ancestor, hidden? other_ancestor_hidden = page.has_css?(".ui-helper-hidden * #{@locator}") # if any of the above conditions are true, then object is invisible invisible = self_hidden || parent_hidden || other_ancestor_hidden end else invisible = !obj.visible? if exists end # the object is visible if it exists and it is not invisible if exists && !invisible true else false end end |
#wait_until_exists(seconds = nil, post_exception = true) ⇒ Object
Wait until the object exists, or until the specified wait time has expired. If the wait time is nil, then the wait time will be Capybara.default_max_wait_time.
310 311 312 313 314 315 316 317 318 319 320 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 310 def wait_until_exists(seconds = nil, post_exception = true) timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds wait = Selenium::WebDriver::Wait.new(timeout: timeout) wait.until { exists? } rescue StandardError if post_exception raise "Could not find UI #{} after #{timeout} seconds" unless exists? else exists? end end |
#wait_until_gone(seconds = nil, post_exception = true) ⇒ Object
Wait until the object no longer exists, or until the specified wait time has expired. If the wait time is nil, then the wait time will be Capybara.default_max_wait_time.
329 330 331 332 333 334 335 336 337 338 339 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 329 def wait_until_gone(seconds = nil, post_exception = true) timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds wait = Selenium::WebDriver::Wait.new(timeout: timeout) wait.until { !exists? } rescue StandardError if post_exception raise "UI #{} remained visible after #{timeout} seconds" if exists? else exists? end end |
#wait_until_hidden(seconds = nil, post_exception = true) ⇒ Object
Wait until the object is hidden, or until the specified wait time has expired. If the wait time is nil, then the wait time will be Capybara.default_max_wait_time.
367 368 369 370 371 372 373 374 375 376 377 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 367 def wait_until_hidden(seconds = nil, post_exception = true) timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds wait = Selenium::WebDriver::Wait.new(timeout: timeout) wait.until { hidden? } rescue StandardError if post_exception raise "UI #{} remained visible after #{timeout} seconds" if visible? else visible? end end |
#wait_until_value_changes(seconds = nil, post_exception = true) ⇒ Object
Wait until the object's value changes to a different value, or until the specified wait time has expired. If the wait time is nil, then the wait time will be Capybara.default_max_wait_time.
408 409 410 411 412 413 414 415 416 417 418 419 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 408 def wait_until_value_changes(seconds = nil, post_exception = true) value = get_value timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds wait = Selenium::WebDriver::Wait.new(timeout: timeout) wait.until { get_value != value } rescue StandardError if post_exception raise "Value of UI #{} failed to change from '#{value}' after #{timeout} seconds" if get_value == value else get_value == value end end |
#wait_until_value_is(value, seconds = nil, post_exception = true) ⇒ Object
Wait until the object's value equals the specified value, or until the specified wait time has expired. If the wait time is nil, then the wait time will be Capybara.default_max_wait_time.
389 390 391 392 393 394 395 396 397 398 399 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 389 def wait_until_value_is(value, seconds = nil, post_exception = true) timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds wait = Selenium::WebDriver::Wait.new(timeout: timeout) wait.until { compare(value, get_value) } rescue StandardError if post_exception raise "Value of UI #{} failed to equal '#{value}' after #{timeout} seconds" unless get_value == value else get_value == value end end |
#wait_until_visible(seconds = nil, post_exception = true) ⇒ Object
Wait until the object is visible, or until the specified wait time has expired. If the wait time is nil, then the wait time will be Capybara.default_max_wait_time.
348 349 350 351 352 353 354 355 356 357 358 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 348 def wait_until_visible(seconds = nil, post_exception = true) timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds wait = Selenium::WebDriver::Wait.new(timeout: timeout) wait.until { visible? } rescue StandardError if post_exception raise "Could not find UI #{} after #{timeout} seconds" unless visible? else visible? end end |
#width ⇒ Integer
Return width of object.
443 444 445 446 447 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 443 def width obj, type = find_element(visible = false) object_not_found_exception(obj, type) obj.get_width end |
#x ⇒ Integer
Return x coordinate of object's location.
467 468 469 470 471 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 467 def x obj, type = find_element(visible = false) object_not_found_exception(obj, type) obj.get_x end |
#y ⇒ Integer
Return y coordinate of object's location.
479 480 481 482 483 |
# File 'lib/testcentricity_web/web_elements/ui_elements_helper.rb', line 479 def y obj, type = find_element(visible = false) object_not_found_exception(obj, type) obj.get_y end |