LogoLogo
  • OFN Testing Documentation
  • Feature Testing Handbook
    • 1. Background
    • 2. Testing
    • 3. Reporting Feedback
    • 4. Launching the next action
  • Manual Testing Handbook
    • 1. Getting started
    • 2. How to do a sanity check (release testing)?
    • 3. How to do a sanity check in production (after a release)?
    • 4. Test cases
    • 5. Work in Progress
  • Automated Testing Handbook
    • System Specs
    • Automate release testing
    • Some more background
    • (R)Spec Conventions
  • Testers Toolkit
    • Multi-Account Containers
    • Flaky specs
    • Re-running Migrations
    • Enabling Open Street Maps
    • Performance testing with Postman
    • Reverting Database Changes
Powered by GitBook
On this page

Was this helpful?

  1. Automated Testing Handbook

System Specs

PreviousAutomated Testing HandbookNextAutomate release testing

Last updated 3 years ago

Was this helpful?

Background

"System tests" are the new replacement for "feature specs" in modern Rails apps. Also, the new driver Ferrum-Cuprite driver does a similar job to Selenium, but it's radically faster and the tests are way more stable (less flaky specs). See also .

Migration from Feature specs into System specs

This is a task which is in progress . The process involves these steps :

  • move spec files from spec/features to into spec/system

  • replace require "spec_helper"with require "system_helper"

  • Use RSpec.describe to define system specs, instead of RSpec.feature

  • Replace the scenario alias in previous feature specs with the standard it syntax (this appears to be optional)

Additionally, other changes may be required. For example:

  • some helper methods were created considered Selenium; these won't work now and need to be adapted to

  • some syntax might not work under system specs, for example background do blocks need to be replaced with before do .

  • the syntax for manipulating cookies with Ferrum is found ; see also .

  • other issues will certainly come up and will be added here

References

relevant thread on Slack
here
(mentioned on this page)
Ferrum
here
this commit
LogoTesting Rails Applications — Ruby on Rails GuidesRuby on Rails Guides
LogoSystem of a test: Proper browser testing in Ruby on Rails — Martian ChroniclesMartian Chronicles
LogoUpgrading to RSpec 3.7.2 and system specs | Everyday Rails