RSpec

エンジニアのためのWebチートシート

基本形

describe 'calculate' do
  it 'is correct' do
    expect(1 + 1).to eq 2
  end
end

describeはテスト対象をグループ化します。 itはテストをexampleという単位にひとまとめにし、itの内部で実行されたテストコードが全てパスした場合に成功とみなされます。 itの中身はテストの本体です。テスト対象の処理と結果を様々なマッチャを使用して比較します。ここでは、'1 + 1' という処理を 'to eq' というマッチャを使用して '2' と等しいかテストしています。

describe

describe 'calculate' do
end

describeはテスト対象をグループ化します。 下記のようにテスト対象の構造をdescribeをネストすることで表現することができます。

describe 'calculate' do
  describe 'sum' do
    it 'is correct' do
      expect(1 + 1).to eq 2
    end
  end
  describe 'minus' do
    it 'is correct' do
      expect(3 - 1).to eq 2
    end
  end
end

it

describe 'calculate' do
  it 'is correct' do
    expect(1 + 1).to eq 2
  end
end

itはテストをexampleという単位にひとまとめにし、itの内部で実行されたテストコードが全てパスした場合に成功とみなされます。 実際にテストを実行した時には下記のように表示されるはずです。

10 examples, 2 failures, 1 pendings

expect

describe 'calculate' do
  it 'is correct' do
    expect(1 + 1).to eq 2
  end
end

'expect' はエクスペクテーションです。 '1 + 1' が '2' と 'to eq'(等しくなること)を期待するという意味です。

context

describe Product do
  describe '#low_price?' do
    context 'when low price' do
      product = Product.new(title: 'Cheatsheet', price: 10)
      it 'return true' do
        expect(product.low_price?).to eq true
      end
    end
    context 'when high price' do
      product = Product.new(title: 'Cheatsheet', price: 10000)
      it 'return false' do
        expect(product.low_price?).to eq false
      end
    end
  end
end

'context' はテストの条件を分岐する時に使用します。 上のテストでは、Productクラスの 'low_price?' というメソッドを'low_price'の時、'high_price'の時という二つの条件でテストしています。

before

describe Product do
  describe '#low_price?' do
    before do
      @product = Product.new(title: 'Cheatsheet')
    end

    context 'when low price' do
      before do
        @product.price = 10
      end
      it 'return true' do
        expect(@product.low_price?).to eq true
      end
    end
    context 'when high price' do
      before do
        @product.price = 10000
      end
      it 'return false' do
        expect(@product.low_price?).to eq false
      end
    end
  end
end

'before' で 'describe' や 'context' 内の共通処理をまとめてコードをDRYに保つことができます。

let

describe Product do
  describe '#low_price?' do
    let(:product) { Product.new(title: 'Cheatsheet') }

    context 'when low price' do
      before do
        product.price = 10
      end
      it 'return true' do
        expect(product.low_price?).to eq true
      end
    end
    context 'when high price' do
      before do
        product.price = 10000
      end
      it 'return false' do
        expect(product.low_price?).to eq false
      end
    end
  end
end

'let' を用いることで遅延評価(変数が必要になるまで呼び出されない)することができます。