Skip to main content

Using pending with examples

RSpec offers a number of different ways to indicate that an example is disabled pending some action.

pending any arbitrary reason with a failing example​

Given a file named "pending_without_block_spec.rb" with:

RSpec.describe "an example" do
  it "is implemented but waiting" do
    pending("something else getting finished")
    fail
  end
end

When I run rspec pending_without_block_spec.rb

Then the exit status should be 0

And the output should contain "1 example, 0 failures, 1 pending"

And the output should contain:

Pending: (Failures listed here are expected and do not affect your suite's status)

  1) an example is implemented but waiting
     # something else getting finished

pending any arbitrary reason with a passing example​

Given a file named "pending_with_passing_example_spec.rb" with:

RSpec.describe "an example" do
  it "is implemented but waiting" do
    pending("something else getting finished")
    expect(1).to be(1)
  end
end

When I run rspec pending_with_passing_example_spec.rb

Then the exit status should not be 0

And the output should contain "1 example, 1 failure"

And the output should contain "FIXED"

And the output should contain "Expected pending 'something else getting finished' to fail. No error was raised."

And the output should contain "pending_with_passing_example_spec.rb:2".

pending for an example that is currently passing​

Given a file named "pending_with_passing_block_spec.rb" with:

RSpec.describe "an example" do
  pending("something else getting finished") do
    expect(1).to eq(1)
  end
end

When I run rspec pending_with_passing_block_spec.rb

Then the exit status should not be 0

And the output should contain "1 example, 1 failure"

And the output should contain "FIXED"

And the output should contain "Expected pending 'No reason given' to fail. No error was raised."

And the output should contain "pending_with_passing_block_spec.rb:2".

pending for an example that is currently passing with a reason​

Given a file named "pending_with_passing_block_spec.rb" with:

RSpec.describe "an example" do
  example("something else getting finished", :pending => 'unimplemented') do
    expect(1).to eq(1)
  end
end

When I run rspec pending_with_passing_block_spec.rb

Then the exit status should not be 0

And the output should contain "1 example, 1 failure"

And the output should contain "FIXED"

And the output should contain "Expected pending 'unimplemented' to fail. No error was raised."

And the output should contain "pending_with_passing_block_spec.rb:2".