Module: Capybara::Node::Actions

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

Instance Method Summary (collapse)

Instance Method Details

- (Object) attach_file(locator, path, options = {})

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


148
149
150
151
152
153
# File 'lib/capybara/node/actions.rb', line 148

def attach_file(locator, path, options={})
  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, options).set(path)
end

- (Object) check(locator, options = {})

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

page.check('German')


81
82
83
# File 'lib/capybara/node/actions.rb', line 81

def check(locator, options={})
  find(:checkbox, locator, options).set(true)
end

- (Object) choose(locator, options = {})

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

page.choose('Male')


68
69
70
# File 'lib/capybara/node/actions.rb', line 68

def choose(locator, options={})
  find(:radio_button, locator, options).set(true)
end

- (Object) click_button(locator, options = {})

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



36
37
38
# File 'lib/capybara/node/actions.rb', line 36

def click_button(locator, options={})
  find(:button, locator, options).click
end

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

Options Hash (options):

  • :href (String)

    The value the href attribute must be



26
27
28
# File 'lib/capybara/node/actions.rb', line 26

def click_link(locator, options={})
  find(:link, locator, options).click
end

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



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

def click_link_or_button(locator, options={})
  find(:link_or_button, locator, options).click
end

- (Object) fill_in(locator, options = {})

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'

Options Hash (options):

  • :with (String)

    The value to fill in - required

  • :fill_options (Hash)

    Driver specific options regarding how to fill fields



52
53
54
55
56
57
# File 'lib/capybara/node/actions.rb', line 52

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

- (Object) select(value, options = {})

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'


109
110
111
112
113
114
115
116
# File 'lib/capybara/node/actions.rb', line 109

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

- (Object) uncheck(locator, options = {})

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

page.uncheck('German')


94
95
96
# File 'lib/capybara/node/actions.rb', line 94

def uncheck(locator, options={})
  find(:checkbox, locator, options).set(false)
end

- (Object) unselect(value, options = {})

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'


129
130
131
132
133
134
135
136
# File 'lib/capybara/node/actions.rb', line 129

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