Receive Counts

When expecting a message, you can specify how many times you expect the message to be received:

• expect(...).to receive(...).once
• expect(...).to receive(...).twice
• expect(...).to receive(...).exactly(n).time
• expect(...).to receive(...).exactly(n).times
• expect(...).to receive(...).at_least(:once)
• expect(...).to receive(...).at_least(:twice)
• expect(...).to receive(...).at_least(n).time
• expect(...).to receive(...).at_least(n).times
• expect(...).to receive(...).at_most(:once)
• expect(...).to receive(...).at_most(:twice)
• expect(...).to receive(...).at_most(n).time
• expect(...).to receive(...).at_most(n).times

If you don't specify an expected receive count, it defaults to once.

Background

Given a file named "lib/account.rb" with:

class Account
  def initialize(logger)
    @logger = logger
  end

  def open
    @logger.account_opened
  end
end

Passing examples

Given a file named "spec/account_spec.rb" with:

require 'account'

RSpec.describe Account do
  let(:logger)  { double("Logger") }
  let(:account) { Account.new(logger) }

  example "once" do
    expect(logger).to receive(:account_opened).once
    account.open
  end

  example "twice" do
    expect(logger).to receive(:account_opened).twice
    account.open
    account.open
  end

  example "exactly(n).time" do
    expect(logger).to receive(:account_opened).exactly(1).time
    account.open
  end

  example "exactly(n).times" do
    expect(logger).to receive(:account_opened).exactly(3).times
    account.open
    account.open
    account.open
  end

  example "at_least(:once)" do
    expect(logger).to receive(:account_opened).at_least(:once)
    account.open
    account.open
  end

  example "at_least(:twice)" do
    expect(logger).to receive(:account_opened).at_least(:twice)
    account.open
    account.open
    account.open
  end

  example "at_least(n).time" do
    expect(logger).to receive(:account_opened).at_least(1).time
    account.open
  end

  example "at_least(n).times" do
    expect(logger).to receive(:account_opened).at_least(3).times
    account.open
    account.open
    account.open
    account.open
  end

  example "at_most(:once)" do
    expect(logger).to receive(:account_opened).at_most(:once)
  end

  example "at_most(:twice)" do
    expect(logger).to receive(:account_opened).at_most(:twice)
    account.open
  end

  example "at_most(n).time" do
    expect(logger).to receive(:account_opened).at_most(1).time
    account.open
  end

  example "at_most(n).times" do
    expect(logger).to receive(:account_opened).at_most(3).times
    account.open
    account.open
  end
end

When I run rspec spec/account_spec.rb

Then the examples should all pass.

Failing examples

Given a file named "spec/account_spec.rb" with:

require 'account'

RSpec.describe Account do
  let(:logger)  { double("Logger") }
  let(:account) { Account.new(logger) }

  example "once" do
    expect(logger).to receive(:account_opened).once
    account.open
    account.open
  end

  example "twice" do
    expect(logger).to receive(:account_opened).twice
    account.open
  end

  example "exactly(n).times" do
    expect(logger).to receive(:account_opened).exactly(3).times
    account.open
    account.open
  end

  example "at_least(:once)" do
    expect(logger).to receive(:account_opened).at_least(:once)
  end

  example "at_least(:twice)" do
    expect(logger).to receive(:account_opened).at_least(:twice)
    account.open
  end

  example "at_least(n).times" do
    expect(logger).to receive(:account_opened).at_least(3).times
    account.open
    account.open
  end

  example "at_most(:once)" do
    expect(logger).to receive(:account_opened).at_most(:once)
    account.open
    account.open
  end

  example "at_most(:twice)" do
    expect(logger).to receive(:account_opened).at_most(:twice)
    account.open
    account.open
    account.open
  end

  example "at_most(n).times" do
    expect(logger).to receive(:account_opened).at_most(3).times
    account.open
    account.open
    account.open
    account.open
  end
end

When I run rspec spec/account_spec.rb --order defined

Then the examples should all fail, producing the following output:

| expected: 1 time with any arguments | | received: 2 times | | | | expected: 2 times with any arguments | | received: 1 time with any arguments | | | | expected: 3 times with any arguments | | received: 2 times with any arguments | | | | expected: at least 1 time with any arguments | | received: 0 times with any arguments | | | | expected: at least 2 times with any arguments | | received: 1 time with any arguments | | | | expected: at least 3 times with any arguments | | received: 2 times with any arguments | | | | expected: at most 1 time with any arguments | | received: 2 times | | | | expected: at most 2 times with any arguments | | received: 3 times | | | | expected: at most 3 times with any arguments | | received: 4 times |