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_present

Constructor Details

#initialize(target_locator) ⇒ Alert

Returns a new instance of Alert.



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

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

Instance Method Details

#close ⇒ Object

Closes alert or cancels prompts/confirms.

Examples:

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


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

def close
  assert_exists
  @alert.dismiss
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) 


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

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

#ok ⇒ Object

Closes alert or accepts prompts/confirms.

Examples:

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


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

def ok
  assert_exists
  @alert.accept
end

#selector_string ⇒ Object

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. 



89
90
91
 
# File 'lib/watir-webdriver/alert.rb', line 89

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) 


64
65
66
67
 
# File 'lib/watir-webdriver/alert.rb', line 64

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

#text ⇒ String

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