Skip to content
By Sean Geoghegan

Use Form Object Model to DRY up request specs

We've recently been working on increasing the integration test coverage for a client app that is very form heavy. Eventually a lot of the forms on this application are going to be redesigned and restructured but before we get started on a big backend refactor we wanted to make sure the frontend coverage is up to scratch.

Typically, the best way to do this is to write Capybara based request specs. This works well but with big forms, it can get a bit unwieldy with a lot of copy and paste between tests. Worse, if your forms are bound to change going back over all the tests and changing CSS locators or Capybara method calls is a bit of a pain.

To work around these issues we created a gem called formobjectmodel. This gem lets you define the fields of your forms separately from the tests that use the forms. For example, with a form that looks something like this:

        <form action="/foo">
          <label for="title">Title</label>
          <select id="title" name="title">

          <label for="name">Name</label>
          <input type="text" name="name" id="name" />

Typically, in a request spec you'd call Capybara directly to fill out the form, like this:

        select("Mr", :from => "Title")
        fill_in("Name", :with => "Joe Bloggs")

Instead, with the formobjectmodel gem, you can declare the fields of the form in an RSpec let block like this:

        let(:form) do
 do |form|
       :title, "Title"
            form.text_field :name, "Name"

Then you can fill out the form using assignment like so:

        form.title = "Mr" = "Joe Bloggs"

And test them like this:

        form.title.should have_value("Mr")  have_value("Joe Bloggs")

The advantage of this is that if your form structure changes you only need to change the definition of the form, not every test that uses it. Plus, IMO, the syntax is a lot nicer and easier to read than a mishmash of direct Capybara calls.

This is somewhat inspired by the Site Prism gem, which is inspired by the Page Object Model from Selenium. But we've pared it back and made it targeted specifically towards making forms easier to test. So if you want to use a similar model for page navigation and content testing you should give Site Prism a go, but if you want a simple way to DRY up your form tests and make them a bit easier to read and maintain, give formobjectmodel a shot.

Popular Articles by Our Team

Our expert team of designers and developers love what the do and enjoy sharing their knowledge with the world.

We Hire Only the Best

reinteractive is Australia’s largest dedicated Ruby on Rails development company. We don’t cut corners and we know what we are doing.

We are an organisation made up of amazing individuals and we take pride in our team. We are 100% remote work enabling us to choose the best talent no matter which part of the country they live in. reinteractive is dedicated to making it a great place for any developer to work.

Free Community Workshops

We created the Ruby on Rails InstallFest and Ruby on Rails Development Hub to help introduce new people to software development and to help existing developers hone their skills. These workshops provide invaluable mentorship to train developers, addressing key skills shortages in the industry. Software development is a great career choice for all ages and these events help you get started and skilled up.

  • Webinars


    Webinars are our online portal for tips, tricks and lessons learned in everything we do. Make the most of this free resource to help you become a better developer.

    Learn more about webinars

  • Installfest


    The Ruby on Rails Installfest includes a full setup of your development environment and step-by-step instructions on how to build your first app hosted on Heroku. Over 1,800 attendees to date and counting.

    Learn more about Installfest

  • Development Hub

    Development Hub

    The Ruby on Rails Development Hub is a monthly event where you will get the chance to spend time with our team and others in the community to improve and hone your Ruby on Rails skills.

    Learn more about Development Hub

Get the “reinteractive Review” Monthly Email