Some neat Capybara selectors and matchers for working with HTML tables.


Add this line to your application's Gemfile:

gem 'capybara_table'

And then execute:

$ bundle

Or install it yourself as:

$ gem install capybara_table

If you're using RSpec, require the matchers:

require "capybara_table/rspec"



If you have a table like this:

    <th>First Name</th>
    <th>Last Name</th>
    <td colspan="2">John</td>

Then you can do this

# find a table by caption
find(:table, "People") # by caption

# find a table row by its headers, even works with colspans!
# (note the extra hash at the end)
find(:table_row, {"First Name" => "Jonas", "Last Name" => "Nicklas"}, {})

# Assert on a table row with RSpec
expect(find(:table "People")).to have_table_row("First Name" => "Jonas", "Last Name" => "Nicklas")

# Assert on a table row with MiniTest
within :table, "People" do
  assert_selector(:table_row, {"First Name" => "Jonas", "Last Name" => "Nicklas"}, {})


The gem is available as open source under the terms of the MIT License.