はじめに

Railsでアプリケーションを開発する際、品質を担保するためにテストは欠かせません。その中でも、RSpecは多くの開発者に愛用されているテストフレームワークです。

今回は、RSpecを使ったRailsアプリケーションのテスト方法について、実践的な視点から解説していきます。

テストの共通化

RSpecにおけるテストの共通化は、コードの再利用性を高め、テストの重複を避けるために重要です。ここでは、shared_examplesの使用とカスタムマッチャーの作成について説明します。

shared_examplesの使用

shared_examplesは、複数のテストケースで共通するテストコードを一箇所にまとめ、再利用するために使用します。これにより、コードの重複を減らし、テストの保守性を向上させることができます。

以下の例では、ユーザーが有効かどうかを検証する共通のテストを作成します。

spec/support/shared_examples/user_validations.rb

RSpec.shared_examples "a valid user" do
  it "is valid with valid attributes" do
    expect(subject).to be_valid
  end

  it "is not valid without a name" do
    subject.name = nil
    expect(subject).not_to be_valid
  end

  it "is not valid without an email" do
    subject.email = nil
    expect(subject).not_to be_valid
  end
end

spec/models/user_spec.rb

require 'rails_helper'
require 'support/shared_examples/user_validations'

RSpec.describe User, type: :model do
  subject { build(:user) }

  it_behaves_like "a valid user"
end

spec/models/admin_spec.rb

require 'rails_helper'
require 'support/shared_examples/user_validations'

RSpec.describe Admin, type: :model do
  subject { build(:admin) }

  it_behaves_like "a valid user"
end

このようにすることで、UserとAdminモデルのテストに共通のバリデーションテストを簡単に再利用できます。

カスタムマッチャーの作成

カスタムマッチャーは、RSpecのデフォルトのマッチャーでは表現しにくい複雑な条件をテストするために使用されます。これにより、テストコードがより読みやすく、メンテナンスしやすくなります。

以下の例では、ユーザーのフルネームを検証するカスタムマッチャーを作成します。

spec/support/custom_matchers.rb

RSpec::Matchers.define :have_full_name do |expected|
  match do |actual|
    actual.full_name == expected
  end

  failure_message do |actual|
    "expected that #{actual.full_name} would be #{expected}"
  end

  failure_message_when_negated do |actual|
    "expected that #{actual.full_name} would not be #{expected}"
  end

  description do
    "have full name #{expected}"
  end
end

spec/models/user_spec.rb

require 'rails_helper'
require 'support/custom_matchers'

RSpec.describe User, type: :model do
  subject { build(:user, first_name: "John", last_name: "Doe") }

  it "has the correct full name" do
    expect(subject).to have_full_name("John Doe")
  end
end