Class: Gridium::Page

Inherits:
Object
  • Object
show all
Defined in:
lib/page.rb

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.assert_selector(by, locator) ⇒ Object 



12
13
14
15
16
17
18
19
 
# File 'lib/page.rb', line 12

def self.assert_selector(by, locator)
  asserted_element = Element.new("Asserted Element", by, locator)
  if asserted_element.eql? nil
    fail("Could not find element on page with locator #{locator} using #{by}")
  else
    Log.info("Asserted Element present with locator #{locator} using #{by}")
  end
end

.evaluate_script(script) ⇒ Object 



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

def self.evaluate_script(script)
  Driver.evaluate_script script
end

.execute_script(script) ⇒ Object 



76
77
78
 
# File 'lib/page.rb', line 76

def self.execute_script(script)
  Driver.execute_script_driver(script)
end

.has_css?(css, options = {}) ⇒ Boolean

Returns:

  • (Boolean) 


21
22
23
24
25
26
27
28
 
# File 'lib/page.rb', line 21

def self.has_css?(css, options={})
  wait = Selenium::WebDriver::Wait.new(:timeout => 5)
  begin
    wait.until {Driver.driver.find_element(:css, css).enabled?}
  rescue Exception
    return false
  end
end

.has_flash?(text) ⇒ Boolean

Returns:

  • (Boolean) 


52
53
54
55
56
57
58
59
60
61
62
63
64
65
 
# File 'lib/page.rb', line 52

def self.has_flash?(text)
  wait = Selenium::WebDriver::Wait.new(:timeout => 5) #5 seconds every 500ms
  begin
    element = wait.until {Driver.html.include? text}
  rescue
    Log.warn("Could not find the flash message!")
  end

  if element
    return true
  else
    return false
  end
end

.has_link?(linktext) ⇒ Boolean

Returns:

  • (Boolean) 


39
40
41
42
43
44
45
46
 
# File 'lib/page.rb', line 39

def self.has_link?(linktext)
  wait = Selenium::WebDriver::Wait.new(:timeout => 5)
  begin
    wait.until {Driver.driver.find_element(:link_text, linktext).enabled?}
  rescue Exception
    return false
  end
end

.has_text?(text) ⇒ Boolean

Returns:

  • (Boolean) 


48
49
50
 
# File 'lib/page.rb', line 48

def self.has_text?(text)
  has_flash?(text)
end

.has_xpath?(xpath, options = {}) ⇒ Boolean

Returns:

  • (Boolean) 


30
31
32
33
34
35
36
37
 
# File 'lib/page.rb', line 30

def self.has_xpath?(xpath, options={})
  wait = Selenium::WebDriver::Wait.new(:timeout => 5)
  begin
    wait.until {Driver.driver.find_element(:xpath, xpath).enabled?}
  rescue Exception
    return false
  end
end

.jquery_loaded? ⇒ Boolean

Returns:

  • (Boolean) 


90
91
92
 
# File 'lib/page.rb', line 90

def self.jquery_loaded?
  self.evaluate_script("jQuery.active").zero?
end

.scroll_to_bottom ⇒ Object 



67
68
69
 
# File 'lib/page.rb', line 67

def self.scroll_to_bottom
  Driver.execute_script_driver('window.scrollTo(0,100000)')
end

.scroll_to_top ⇒ Object 



71
72
73
74
 
# File 'lib/page.rb', line 71

def self.scroll_to_top
  #TODO Verify this
  Driver.execute_script_driver('window.scrollTo(100000,0)')
end

.switch_to_default ⇒ Object 



8
9
10
 
# File 'lib/page.rb', line 8

def self.switch_to_default
  Driver.driver.switch_to.default_content
end

.switch_to_frame(frame) ⇒ Object 



4
5
6
 
# File 'lib/page.rb', line 4

def self.switch_to_frame(frame)
  Driver.driver.switch_to.frame(frame)
end

.wait_for_ajax ⇒ Object 



84
85
86
87
88
 
# File 'lib/page.rb', line 84

def self.wait_for_ajax
  Timeout.timeout(Gridium.config.page_load_timeout) do
    loop until jquery_loaded?
  end
end

Instance Method Details

#all(by, locator) ⇒ Object 



94
95
96
 
# File 'lib/page.rb', line 94

def all(by, locator)
  Driver.driver.find_elements(by, locator)
end

#check(id) ⇒ Object

checks a checkbox



139
140
141
 
# File 'lib/page.rb', line 139

def check(id) #checks a checkbox
  Driver.driver.find_element(:id, id).click
end

#click_button(button_name, button_index: nil) ⇒ Object

Click the button on the page

Parameters:

  • link_text (String) —

    • Text of the link to click

  • link_index (Integer) —

    • With multiple links on the page with the same name, click on the specified link index (Defaults to first link found)



124
125
126
127
128
129
130
131
132
133
134
135
136
137
 
# File 'lib/page.rb', line 124

def click_button(button_name, button_index: nil)
  #The button maybe a link that looks like a button - we want to handle both
  if button_index
    button = Element.new("Clicking #{button_name} button (#{button_index})", :xpath, "(//button[contains(., '#{button_name}')])[#{button_index}]")
  else
    button = Element.new("Clicking #{button_name} button", :xpath, "//button[contains(., '#{button_name}')]")
  end
  begin
    button.click
  rescue Exception
    Log.debug("Button not found - Attempting Link - speed up test by using click_link method if this works...")
    click_link button_name, link_index: button_index
  end
end

#click_link(link_text, link_index: nil) ⇒ Object

Click the link on the page

Parameters:

  • link_text (String) —

    • Text of the link to click

  • link_index (Integer) (defaults to: nil) —

    (optional) - With multiple links on the page with the same name, click on the specified link index



113
114
115
116
117
118
119
 
# File 'lib/page.rb', line 113

def click_link(link_text, link_index: nil)
  if link_index
    Element.new("Clicking #{link_text} Link (#{link_index})", :xpath, "(//a[contains(., '#{link_text}')])[#{link_index}]").click
  else
    Element.new("Clicking #{link_text} Link", :xpath, "//a[contains(., '#{link_text}')]").click
  end
end

#click_on(text) ⇒ Object 



106
107
108
 
# File 'lib/page.rb', line 106

def click_on(text)
  Element.new("Clicking #{text}", :xpath, "//*[text()='#{text}')]").click
end

#find(by, locator) ⇒ Object 



98
99
100
 
# File 'lib/page.rb', line 98

def find(by, locator)
  Element.new("Page Find Element", by, locator)
end

#first(by, locator) ⇒ Object 



102
103
104
 
# File 'lib/page.rb', line 102

def first(by, locator)
  Driver.driver.find_elements(by, locator).first
end