Module: Capybara::Node::Actions

Included in:
Base
Defined in:
lib/capybara/node/actions.rb

Instance Method Summary collapse

Instance Method Details

#attach_file(locator, path) ⇒ Object

Find a file field on the page and attach a file given its path. The file field can be found via its name, id or label text.

page.attach_file(locator, '/path/to/file.png')

Parameters:

  • locator (String) —

    Which field to attach the file to

  • path (String) —

    The path of the file that will be attached

Raises:



140
141
142
143
 
# File 'lib/capybara/node/actions.rb', line 140

def attach_file(locator, path)
  raise Capybara::FileNotFound, "cannot attach file, #{path} does not exist" unless File.exist?(path.to_s)
  find(:file_field, locator).set(path)
end

#check(locator) ⇒ Object

Find a check box and mark it as checked. The check box can be found via name, id or label text.

page.check('German')

Parameters:

  • locator (String) —

    Which check box to check



75
76
77
 
# File 'lib/capybara/node/actions.rb', line 75

def check(locator)
  find(:checkbox, locator).set(true)
end

#choose(locator) ⇒ Object

Find a radio button and mark it as checked. The radio button can be found via name, id or label text.

page.choose('Male')

Parameters:

  • locator (String) —

    Which radio button to choose



62
63
64
 
# File 'lib/capybara/node/actions.rb', line 62

def choose(locator)
  find(:radio_button, locator).set(true)
end

#click_button(locator) ⇒ Object

Finds a button by id, text or value and clicks it.

Parameters:

  • locator (String) —

    Text, id or value of button



34
35
36
 
# File 'lib/capybara/node/actions.rb', line 34

def click_button(locator)
  find(:button, locator).click
end

#click_link(locator) ⇒ Object

Finds a link by id or text and clicks it. Also looks at image alt text inside the link.

Parameters:

  • locator (String) —

    Text, id or text of link



24
25
26
 
# File 'lib/capybara/node/actions.rb', line 24

def click_link(locator)
  find(:link, locator).click
end

#click_link_or_button(locator) ⇒ Object Also known as: click_on

Finds a button or link by id, text or value and clicks it. Also looks at image alt text inside the link.

Parameters:

  • locator (String) —

    Text, id or value of link or button



12
13
14
 
# File 'lib/capybara/node/actions.rb', line 12

def click_link_or_button(locator)
  find(:link_or_button, locator).click
end

#fill_in(locator, options = {}) ⇒ Object

Locate a text field or text area and fill it in with the given text The field can be found via its name, id or label text.

page.fill_in 'Name', :with => 'Bob'

Parameters:

  • locator (String) —

    Which field to fill in

  • The (Hash{:with => String}) —

    value to fill in



48
49
50
51
 
# File 'lib/capybara/node/actions.rb', line 48

def fill_in(locator, options={})
  raise "Must pass a hash containing 'with'" if not options.is_a?(Hash) or not options.has_key?(:with)
  find(:fillable_field, locator).set(options[:with])
end

#select(value, options = {}) ⇒ Object

Find a select box on the page and select a particular option from it. If the select box is a multiple select, select can be called multiple times to select more than one option. The select box can be found via its name, id or label text.

page.select 'March', :from => 'Month'

Parameters:

  • value (String) —

    Which option to select

  • The (Hash{:from => String}) —

    id, name or label of the select box



103
104
105
106
107
108
109
 
# File 'lib/capybara/node/actions.rb', line 103

def select(value, options={})
  if options.has_key?(:from)
    find(:select, options[:from]).find(:option, value).select_option
  else
    find(:option, value).select_option
  end
end

#uncheck(locator) ⇒ Object

Find a check box and mark uncheck it. The check box can be found via name, id or label text.

page.uncheck('German')

Parameters:

  • locator (String) —

    Which check box to uncheck



88
89
90
 
# File 'lib/capybara/node/actions.rb', line 88

def uncheck(locator)
  find(:checkbox, locator).set(false)
end

#unselect(value, options = {}) ⇒ Object

Find a select box on the page and unselect a particular option from it. If the select box is a multiple select, unselect can be called multiple times to unselect more than one option. The select box can be found via its name, id or label text.

page.unselect 'March', :from => 'Month'

Parameters:

  • value (String) —

    Which option to unselect

  • The (Hash{:from => String}) —

    id, name or label of the select box



122
123
124
125
126
127
128
 
# File 'lib/capybara/node/actions.rb', line 122

def unselect(value, options={})
  if options.has_key?(:from)
    find(:select, options[:from]).find(:option, value).unselect_option
  else
    find(:option, value).unselect_option
  end
end