RSpecの基本的な構文や便利な機能を理解する

参考：https://qiita.com/jnchito/items/42193d066bd61c740612

describe / it / expect の役割を理解する

describe '四則演算' do
  it '1 + 1 は 2 になること' do
    expect(1 + 1).to eq 2
  end
end

describe

describeはテストのグループ化を宣言する。日本語にすると、「～を述べる」「～を説明する」「～を記述する」という意味。 describe '四則演算'の文字列の部分はそれだけでなくdescribe Userのようにクラスも渡せる。

it

itはテストをexampleという単位にまとめる役割をします。 it do ... endの中のエクスペクテーション（期待値と実際の値の比較）がすべてパスすれば、そのexampleはパスしたことになる。

expect

expect(X).to eq Yで記述するのがエクスペクテーション。 expectには「期待する」という意味があり、expect(X).to eq Yは「XがYに等しくなることを期待する」と読めます。よって、 expect(1 + 1).to eq 2 は「1 + 1 が 2 になることを期待する」テストになる。

context と before でもう少し便利に

describe User do
  describe '#greet' do
    before do
      @params = { name: 'たろう' }
    end
    context '12歳以下の場合' do
      it 'ひらがなで答えること' do
        user = User.new(@params.merge(age: 12))
        expect(user.greet).to eq 'ぼくはたろうだよ。'
      end
    end
    context '13歳以上の場合' do
      it '漢字で答えること' do
        user = User.new(@params.merge(age: 13))
        expect(user.greet).to eq '僕はたろうです。'
      end
    end
  end
end

context

describe以外にもcontextという機能でテストをグループ化することができる。どちらも機能的には同じだが、contextは条件を分けたりするときに使うことが多い。日本語で「文脈」や「状況」の意味。

before

before do ... endで囲まれた部分はexampleの実行前に毎回呼ばれる。 beforeブロックの中では、テストを実行する前の共通処理やデータのセットアップ等を行うことが多い。 describeやcontextがネストしている場合は、親子関係に応じてbeforeが順番に呼ばれる。(親→子の順番)

インスタンス変数のかわりに let を使う

letの利点について：https://qiita.com/jnchito/items/cdd9eef2ed193267c651

describe User do
  describe '#greet' do
    let(:user) { User.new(params) }
    let(:params) { { name: 'たろう', age: age } }
    context '12歳以下の場合' do
      let(:age) { 12 }
      it 'ひらがなで答えること' do
        expect(user.greet).to eq 'ぼくはたろうだよ。'
      end
    end
    context '13歳以上の場合' do
      let(:age) { 13 }
      it '漢字で答えること' do
        expect(user.greet).to eq '僕はたろうです。'
      end
    end
  end
end

let(:foo) { ... }のように書くと、{ ... }の中の値がfooとして参照できる。 letは「before + インスタンス変数」を使うときとは異なり、 遅延評価される という特徴がある。すなわち、letは必要になる瞬間まで呼び出されない。

subject を使ってテスト対象のオブジェクトを1箇所にまとめる

日本語で「主語」や「対象」という意味。テスト対象のオブジェクト（またはメソッドの実行結果）が明確に一つに決まっている場合は、subjectという機能を使うとテストコードが綺麗になる。

describe User do
  describe '#greet' do
    let(:user) { User.new(params) }
    let(:params) { { name: 'たろう', age: age } }
    subject { user.greet }
    context '12歳以下の場合' do
      let(:age) { 12 }
      it 'ひらがなで答えること' do
        is_expected.to eq 'ぼくはたろうだよ。'
      end
    end
    context '13歳以上の場合' do
      let(:age) { 13 }
      it { is_expected.to eq '僕はたろうです。' } # itをこのように書くこともできる
    end
  end
end

今までexpect(user.greet).to eq 'ぼくはたろうだよ。'と書いていた部分がis_expected.to eq 'ぼくはたろうだよ。'と簡潔にできる。

it のエイリアス＝ example と specify

RSpecにはitの他に全く同じ役割のexampleとspecifyがある。これら3つのメソッドはエイリアスの関係にあるので、以下のテストコードは内部的には全く同じ意味になる。なぜ3種類も同じメソッドがあるのかというと、自然な英文を作るため。日本語を使う場合は使い分けせずにitで統一したほうがいい。

it '1 + 1 は 2 になること' do
  expect(1 + 1).to eq 2
end

specify '1 + 1 は 2 になること' do
  expect(1 + 1).to eq 2
end

example '1 + 1 は 2 になること' do
  expect(1 + 1).to eq 2
end