Capybara::Node::Actions

Public Instance Methods

attach_file(locator, path) click to toggle source

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')

@param [String] locator Which field to attach the file to @param [String] path The path of the file that will be attached, or an array of paths

# File lib/capybara/node/actions.rb, line 140
def attach_file(locator, path)
  Array(path).each do |p|
    raise Capybara::FileNotFound, "cannot attach file, #{p} does not exist" unless File.exist?(p.to_s)
  end
  find(:file_field, locator).set(path)
end
check(locator) click to toggle source

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

page.check('German')

@param [String] locator Which check box to check

# File lib/capybara/node/actions.rb, line 75
def check(locator)
  find(:checkbox, locator).set(true)
end
choose(locator) click to toggle source

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

page.choose('Male')

@param [String] locator Which radio button to choose

# File lib/capybara/node/actions.rb, line 62
def choose(locator)
  find(:radio_button, locator).set(true)
end
click_button(locator) click to toggle source

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

@param [String] locator Text, id or value of button

# File lib/capybara/node/actions.rb, line 34
def click_button(locator)
  find(:button, locator).click
end
click_on(locator) click to toggle source
fill_in(locator, options={}) click to toggle source

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'

@param [String] locator Which field to fill in @param [Hash{:with => String}] The value to fill in

# 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={}) click to toggle source

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'

@param [String] value Which option to select @param [Hash{:from => String}] The id, name or label of the select box

# 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) click to toggle source

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

page.uncheck('German')

@param [String] locator Which check box to uncheck

# File lib/capybara/node/actions.rb, line 88
def uncheck(locator)
  find(:checkbox, locator).set(false)
end
unselect(value, options={}) click to toggle source

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'

@param [String] value Which option to unselect @param [Hash{:from => String}] The id, name or label of the select box

# 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

[Validate]

Generated with the Darkfish Rdoc Generator 2.