Class: Watir::Alert

Inherits:
Object
  • Object
show all
Includes:
EventuallyPresent
Defined in:
lib/watir-webdriver/alert.rb

Instance Method Summary collapse

Methods included from EventuallyPresent

#wait_until_present, #wait_while_present, #when_enabled, #when_present

Constructor Details

#initialize(browser) ⇒ Alert

Returns a new instance of Alert.


6
7
8
9
# File 'lib/watir-webdriver/alert.rb', line 6

def initialize(browser)
  @browser = browser
  @alert = nil
end

Instance Method Details

#closeObject

Closes alert or cancels prompts/confirms.

Examples:

browser.alert.close
browser.alert.exists?
#=> false

50
51
52
53
54
# File 'lib/watir-webdriver/alert.rb', line 50

def close
  assert_exists
  @alert.dismiss
  @browser.after_hooks.run
end

#exists?Boolean Also known as: present?

Returns true if alert, confirm or prompt is present and false otherwise.

Examples:

browser.alert.exists?
#=> true

Returns:

  • (Boolean)

79
80
81
82
83
84
# File 'lib/watir-webdriver/alert.rb', line 79

def exists?
  assert_exists
  true
rescue Exception::UnknownObjectException
  false
end

#okObject

Closes alert or accepts prompts/confirms.

Examples:

browser.alert.ok
browser.alert.exists?
#=> false

35
36
37
38
39
# File 'lib/watir-webdriver/alert.rb', line 35

def ok
  assert_exists
  @alert.accept
  @browser.after_hooks.run
end

#selector_stringObject

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.


91
92
93
# File 'lib/watir-webdriver/alert.rb', line 91

def selector_string
  'alert'
end

#set(value) ⇒ Object

Enters text to prompt.

Examples:

browser.alert.set "Text for prompt"
browser.alert.ok

Parameters:

  • value (String)

66
67
68
69
# File 'lib/watir-webdriver/alert.rb', line 66

def set(value)
  assert_exists
  @alert.send_keys(value)
end

#textString

Returns text of alert.

Examples:

browser.alert.text
#=> "ok"

Returns:

  • (String)

21
22
23
24
# File 'lib/watir-webdriver/alert.rb', line 21

def text
  assert_exists
  @alert.text
end