Module: Watir::EventuallyPresent

Included in:
Alert, Element, Window
Defined in:
lib/watir-webdriver/wait.rb

Overview

Convenience methods for things that eventually become present.

Includers should implement a public #present? and a (possibly private) #selector_string method.

Instance Method Summary collapse

Instance Method Details

#wait_until_present(timeout = nil) ⇒ Object

Waits until the element is present.

Examples:

browser.text_field(name: "new_user_first_name").wait_until_present

Parameters:

  • timeout (Fixnum) (defaults to: nil)

    seconds to wait before timing out

See Also:



170
171
172
173
174
# File 'lib/watir-webdriver/wait.rb', line 170

def wait_until_present(timeout = nil)
  timeout ||= Watir.default_timeout
  message = "waiting for #{selector_string} to become present"
  Watir::Wait.until(timeout, message) { present? }
end

#wait_while_present(timeout = nil) ⇒ Object

Waits while the element is present.

Examples:

browser.text_field(name: "abrakadbra").wait_while_present

Parameters:

  • timeout (Fixnum) (defaults to: nil)

    seconds to wait before timing out

See Also:



188
189
190
191
192
193
194
# File 'lib/watir-webdriver/wait.rb', line 188

def wait_while_present(timeout = nil)
  timeout ||= Watir.default_timeout
  message = "waiting for #{selector_string} to disappear"
  Watir::Wait.while(timeout, message) { present? }
rescue Selenium::WebDriver::Error::StaleElementReferenceError
  # it's not present
end

#when_present(timeout = nil) ⇒ Object

Waits until the element is present.

Examples:

browser.text_field(name: "new_user_first_name").when_present.click
browser.text_field(name: "new_user_first_name").when_present { |field| field.set "Watir" }
browser.text_field(name: "new_user_first_name").when_present(60).text

Parameters:

  • timeout (Fixnum) (defaults to: nil)

    seconds to wait before timing out

See Also:



146
147
148
149
150
151
152
153
154
155
156
# File 'lib/watir-webdriver/wait.rb', line 146

def when_present(timeout = nil)
  timeout ||= Watir.default_timeout
  message = "waiting for #{selector_string} to become present"

  if block_given?
    Watir::Wait.until(timeout, message) { present? }
    yield self
  else
    WhenPresentDecorator.new(self, timeout, message)
  end
end