--fail-fast option

Use the --fail-fast option to tell RSpec to stop running the test suite on the first failed test.

You may add a parameter to tell RSpec to stop running the test suite after N failed tests, for example: --fail-fast=3.

You can also specify --no-fail-fast to turn it off (default behaviour).

Background

Given a file named “failfastspec.rb” with:

RSpec.describe "fail fast" do
  it "passing test" do; end
  it "1st failing test" do
    fail
  end
  it "2nd failing test" do
    fail
  end
  it "3rd failing test" do
    fail
  end
  it "4th failing test" do
    fail
  end
  it "passing test" do; end
end

Using --fail-fast

When I run rspec . --fail-fast

Then the output should contain “.F”

Then the output should not contain “.F.”.

Using --fail-fast=3

When I run rspec . --fail-fast=3

Then the output should contain “.FFF”

Then the output should not contain “.FFFF.”.

Using --no-fail-fast

When I run rspec . --no-fail-fast

Then the output should contain “.FFFF.”.