はじめに
Railsのテストについて書きます。
RSpecを使ったモデルの単体テストです。バリデーションがうまく働くかどうかを確認することがメインとなります。
RSpec導入
まずはgemをインストールします。
Gemfileを編集し、bundleインストールしましょう。
group :development, :test do
gem 'rspec-rails'
end
# web-consoleというgemがtest環境の中にある場合はdevelopmentのみに移しておく
group :development do
gem 'web-console'
end
$ bundle install
続いてrspec用のファイルを用意します。
$ rails g rspec:install
これでいくつかファイルが追加されたと思います。
以下を追加されたファイルの.rspecに追記します。
--format documentation
続いて必要なディレクトリを用意しておきます。
spec/modelsディレクトリを作成
続いてテストコードを書くファイルを用意したmodelsディレクトリの中に作成します。
今回はpost_spec.rbを作成することにします。
ファイル名はモデル名_spec.rbとしましょう。
これで準備はOKです。
テストコード記述
テストコードを書いてみます。
require 'rails_helper' # rails_helperを使うために必要です。何も考えず書いてください
describe Post do # Postモデルについて
describe '#create' do # createアクションについて
it "contentがない場合は登録できないこと" do # テストの確認内容を記述
post = Post.new(content: "") # Postモデルのインスタンス（データ）を作成
post.valid? # インスタンスを保存する際に、バリデーションにより保存ができない状態であるかを確かめる
expect(post.errors[:content]).to include("can't be blank") # エラー文に"can't be blank"が含まれるかどうかを判定
end
end
end
それぞれの処理はコメントアウトで書いたとおりですが、コンソールで一つずつ確かめてみるともう少し理解できると思うので試してみましょう！
ターミナルでコンソール画面を立ち上げてみましょう。
$ rails c
テストコードのit 〜 endを順番に実行してみます。
[1]ここでPostモデルのインスタンス（contentカラムが空）が作成されます。
[2]上で作成したインスタンスが保存に失敗すればfalseが返ってきます。
valid?やinvalid?メソッドについての詳しい話はここを参考にしてください。
[3]エラー文はerrorsメソッドを使って見ることができます。
@messageにエラーメッセージが出ています。
今回Postモデルには空を許さないバリデーションの他に、最低でも２文字というバリデーションも書いてあるので、その２つのエラーが出ています。
便利なツール（FactoryBot）
上の例で使ったPostモデルはカラムが少なく、テスト用のデータを作成するのが簡単でした。
しかし、名前やメールアドレス、パスワードなどの複数の情報を持つUserモデルなんかだと、いちいちデータを書いていくのが面倒です。
user = User.new(name: "hoge", email: "hoge@gmail.com", password: "xxxxxx")
このように書かなくてはいけなくなり、冗長なコードになってしまいます。
FactoryBotというgemを使えばデフォルトのデータを用意しておき、必要な箇所だけデータを変更して使えるので便利です。
導入方法、使い方を順番に書いていきます。
まずはgemを入れます。
group :development, :test do
#省略
gem 'factory_bot_rails'
end
$ bundle install
spec/factoriesディレクトリを作成します。
続いてデータを書くファイルを用意したfactoriesディレクトリの中に作成します。
今回はusers.rbを作成することにします。
ファイル名はモデル名の複数形.rbとしましょう。
書き方は以下のとおりです。
FactoryBot.define do
factory :user do
nickname {"neko"}
email {"neko@gmail.com"}
password {"nyannyan"}
password_confirmation {"nyannyan"}
profile {"hello"}
end
end
factory_botを使うことで、specファイルで簡単にインスタンスを作成できます。
user = FactoryBot.create(:user)
と記述するだけでusers.rbで用意したインスタンスを作成してくれます。
実はもう少しだけ簡単に書くことができるのでその設定もしておきましょう。
factory_botの記法の省略
rails_helperに以下のように追記します。
RSpec.configure do |config|
# 以下を追記
config.include FactoryBot::Syntax::Methods
# (省略)
end
これを使って、例えばUserモデルのテストを書いてみます。
require 'rails_helper'
describe User do
describe '#create' do
it "nikcnameがない場合は登録できないこと" do
user = build(:user, nickname: "")
user.valid?
expect(user.errors[:nickname]).to include("を入力してください")
end
it "emailがない場合は登録できないこと" do
user = build(:user, email: "")
user.valid?
expect(user.errors[:email]).to include("を入力してください")
end
end
end
このようにbuild(:モデル名)とすることでインスタンスを作成できます。
空データなど、factory_botで用意した値と違う値を使いたい場合は、build(:モデル名, カラム名: 値)とすればOKです。
テストの実行
テストを実行するにはターミナルからコマンドを入力するだけでOKです。
$ bundle exec rspec
テストが通るとこんな感じで表示されます。
失敗すると通らなかったテストの数だけfeiluresの数字がカウントされ、エラー内容が表示されます。
ファイルを指定してテストを実行
上で書いたコマンドbundle exec rspecはspecファイル全てを実行してしまうので、すでに確認済みのテストがある場合は少し無駄が出てしまいます。
$ bundle exec rspec spec/ディレクトリ名/ファイル名（_spec.rb）
とすることでファイルを指定して実行できます。
今回使用したuserモデルのテストを例にすると以下のようになります。
$ bundle exec rspec spec/models/user_spec.rb