Rails 인증 생성기 테스트: 새로운 세션 테스트 헬퍼 활용

Rails 인증 생성기는 애플리케이션에 인증 기능을 추가하기 위해 모듈, 사용자 모델, 세션 모델을 생성합니다. 이러한 기능의 테스트는 사용자 경험의 핵심이므로 중요합니다. 새로운 session_test_helper 모듈은 이러한 테스트를 더욱 효율적으로 수행할 수 있도록 돕습니다. 이 모듈은 sign_in_as(user) 및 sign_out과 같은 두 가지 주요 메서드를 제공합니다. ### session_test_helper의 동작 원리 * sign_in_as(user): 이 메서드는 사용자 세션을 생성하고, 생성된 세션 ID를 쿠키에 추가하여 사용자가 로그인된 상태를 시뮬레이션합니다. * sign_out: 사용자를 로그아웃시키는 기능을 제공합니다. ### 통합 테스트에서의 활용 통합 테스트(Integration Test)는 HTTP 요청을 직접 시뮬레이션하므로, session_test_helper는 cookies 객체에 직접 접근하여 세션 ID를 설정할 수 있습니다. 예를 들어, 로그인하지 않은 사용자가 프로필 편집 페이지에 접근하려 할 때 로그인 페이지로 리디렉션되는지 확인하고, 로그인된 사용자가 프로필 편집 페이지에 성공적으로 접근하는지 테스트할 수 있습니다. ruby test "guests cannot edit their profile" do get edit_profile_path assert_redirected_to new_session_path end test "signed in users can edit their profile" do sign_in_as users(:one) get edit_profile_path assert_response :success end ### 시스템 테스트에서의 활용 시스템 테스트(System Test)는 실제 브라우저 환경에서 실행되므로, 통합 테스트와 같이 cookies 객체에 직접 접근하는 방식은 사용할 수 없습니다. session_test_helper는 시스템 테스트 환경을 감지하여 다른 방식으로 동작합니다. * 쿠키 주입 방식: 1. 먼저 애플리케이션의 유효한 URL(예: new_session_url)을 방문하여 브라우저 컨텍스트를 설정합니다. 2. Capybara의 page.driver.browser.manage.add_cookie 메서드를 사용하여 session_id 쿠키를 직접 브라우저에 주입합니다. 이때 same_site: :lax, http_only: true와 같은 속성도 설정할 수 있습니다. 3. 이후 테스트하려는 페이지(edit_profile_url)를 방문하면 사용자가 로그인된 상태로 간주됩니다. ruby test "guest cannot edit their profile (system test)" do visit edit_profile_url assert_selector "h1", text: "Login" end test "user can edit their profile (system test)" do sign_in_as users(:one) # 시스템 테스트용 로직이 내부적으로 처리됨 visit edit_profile_url assert_selector "h1", text: "Profile" end ### 이점 이러한 쿠키 직접 주입 방식은 시스템 테스트에서 로그인 폼을 채우고 제출하는 과정을 생략함으로써 테스트 실행 시간을 25%까지 단축할 수 있습니다. 이는 특히 JavaScript 상호작용이 많은 Hotwire 애플리케이션과 같은 경우에 유용하며, Selenium과 같은 드라이버를 사용하는 시스템 테스트의 효율성을 크게 높여줍니다. 이 기능은 Rails의 다음 릴리스에 포함될 예정이며, 현재는 Pull Request를 통해 미리 사용해 볼 수 있습니다.