初学者の備忘録です！間違い等あればご指摘お願いいたします！
非常に分かりやすい参考記事様 ▶︎https://qiita.com/jnchito/items/2e79a1abe7cd8214caa5
- Ruby2.6.5
- Rails6.0.0
前提
こちらの記事では、Rspecを導入した後の手順を記述しております。
未実装の方はこちらを参考にどうぞ→Rspecの導入方法
結合テストコードの準備
結合テストコードは、単体テストコードのように一つ一つの項目のテストだけでなく、ユーザーが辿るであろう一連の流れを確認するためのものです！
単体を一つの流れにくっ付ける、その名の通り**「結合テスト」**ですね！
単体と違う部分は他にもあり、実行コマンドの変化や、**「Capybara」**というGemを使います！
順に見ていきましょう！
System Spec
System Specは、結合テストコードを記述するための仕組みです。
Capybara
Capybara（カピバラ）はSystem Specを記述するために必要なGemのことです。
Gemfileを確認すると、すでに搭載されていることが分かります！
Gemfile
group :test do
# Adds support for Capybara system testing and selenium driver
gem 'capybara', '>= 2.15'
(略)
end
System Spec(結合テストコードの仕組み)を使うために、CapybaraというGemを使ってく、というイメージです！
では、早速結合テストコードを書いていきましょう！
テストコードを記述するファイルの用意
単体テストと同様に、ターミナル上でファイルを生成していきます！
（今回もUserに関するテストコードを記述しますので、記述したいテストにより名前を変えてください！）
ターミナル
rails g rspec:system users
今回の場合、spec/system/users_spec.rbというファイルを作りました！
systemディレクトリ内に入ってるのが結合テストコードってことですね！
exampleの整理(何をどのような流れでテストするのか？)
単体テストコードでは詳細の記述をしませんでしたが、テストコードを書く上で一番大事と言っても過言ではないです。
特に結合テストコードでは一連の流れを考えるわけですからね！
細かく言語化することが重要です。私は実際にユーザーになって動くたびに挙動の記述を繰り返して書いてます！
テストコードに落とし込み、記述
exampleを書き出したらさっき作ったファイルに書いていきます！（以下は例です）
exampleについては#でコメントアウトします。
spec/system/users_spec.rb
require 'rails_helper'
RSpec.describe 'ユーザー新規登録', type: :system do
before do
@user = FactoryBot.build(:user)
end
context 'ユーザー新規登録ができるとき' do
it '正しい情報を入力すればユーザー新規登録ができてトップページに移動する' do
# トップページに移動する
# トップページにサインアップページへ遷移するボタンがあることを確認する
# 新規登録ページへ移動する
# ユーザー情報を入力する
# サインアップボタンを押すとユーザーモデルのカウントが1上がることを確認する
# トップページへ遷移する
# カーソルを合わせるとログアウトボタンが表示されることを確認する
# サインアップページへ遷移するボタンや、ログインページへ遷移するボタンが表示されていないことを確認する
end
end
ここにコードの肉付けをしていきます！！
そのために必要なコードの記述方をみていきましょう。
新規登録がうまくいくときのテストコード(一例)
トップページに移動する
▶︎visit
visit 〇〇_pathのように記述すると、〇〇のページへ移動する挙動を表現します。
今回はトップということでroot_pathに指定してます。
rails routesで確認し記述しましょう！
# トップページに移動する
visit root_path
次にいきましょう！
トップページにサインアップページへ遷移するボタンがあることを確認する
▶︎page
visitで訪れたページの見える部分(画面上で見えているもの)の情報が保持されています。
「カーソルを合わせないと確認できない」場合は別メソッドhoverが必要です。(下記に記述しています)
# トップページにサインアップページへ遷移するボタンがあることを確認する
expect(page).to have_content('新規登録')
新規登録ページへ移動する
これはトップページに遷移すると同様なので省略します。
ユーザー情報を入力する
▶︎fill_in
fill_in 'フォームの名前', with: '入力する文字列'と記述することで、フォームへの入力を行うことができます。
勝手に書いてくれる優れものです！
フォームの名前は検証ツールやhtmlから確認できます。
※label要素のforに指定されているIDと、inputのidの値が同一になっていることを確認しましょう。
入力する文字列に関しては、Fakerなどを活用してみましょう！
visit new_user_registration_path
# ユーザー情報を入力する
fill_in 'Nickname', with: @user.nickname
fill_in 'Email', with: @user.email
fill_in 'Password', with: @user.password
fill_in 'Password confirmation', with: @user.password_confirmation
さぁどんどん行きましょう！
サインアップボタンを押すとユーザーモデルのカウントが1上がることを確認する
▶︎find().click
find('クリックしたい要素').clickと記述することで、実際にクリックができます。
ここでも検証ツールを使ってみましょう！
具体的には、input要素のname属性を指定します。
今回は、
****と記述してありました。
この場合、find('input[name="commit"]').clickという記述をすればokです。
サインアップのボタンを押すことは学びましたが、このままでは求めている挙動を満たしてません。
ユーザーモデルのカウントが1上がることの確認をどうするか？
ハイ！マッチャを使ってダブル使いします！
▶︎change
expect{ 行う動作 }.to change { モデル名.count }.by(1)と記述することで、モデルのレコードの数がいくつ変動するのかを確認をします。
(1)を（0）にすれば、動作しなかった場合のテストコードにも使えますね！
行う動作に先ほど覚えたfind('クリックしたい要素').clickを入れればok!
# サインアップボタンを押すとユーザーモデルのカウントが1上がることを確認する
expect{
find('input[name="commit"]').click
}.to change { User.count }.by(1)
トップページへ遷移する
ここでvisitを使いたくなりますがちょっと待ってください！
確かに移動するという点では同じです。しかし違う点があります！
今回は、新規登録をする→トップページにリダイレクトするという挙動を実現したいんですよね。
なので、今いるページがどこなのかを確認したいです。
そのときに使いたいのが**current_path(現在いるページのパスを自動指定)**です！
# トップページへ遷移したことを確認する
expect(current_path).to eq(root_path)
カーソルを合わせるとログアウトボタンが表示されることを確認する
▶︎hover
隠している特定の要素を確認することができます。クラスなどを指定する場合はその親要素の記述も必要になります！
expect(
find('.user_nav').hover
).to have_content('ログアウト')
サインアップページへ遷移するボタンや、ログインページへ遷移するボタンが表示されていないことを確認する
▶︎have_no_content
have_contentの逆です。文字列が存在しないことの確認ができます。
テストコードを実行する
ここまで記述お疲れ様でした！
最後に以下のコマンドで確認してください。
ターミナル
% bundle exec rspec spec/system/users_spec.rb
パソコン上でババーっと自動的に挙動確認をしてくれるはずです！
問題なく最後まで実行され、ターミナルにもエラー文が出なければ完成です！