Turbo Rails Gem에 Turbo Frame 테스트 헬퍼 추가 및 구현

Adding Turbo Frame Test Helpers

작성자
Hotwire Weekly
발행일
2025년 06월 16일
원문 보기
www.youtube.com

핵심 요약

  • 1 Turbo Rails Gem에 통합 테스트 시 Turbo Frame의 존재 여부 및 속성 검증을 위한 `assert_turbo_frame` 및 `assert_no_turbo_frame` 헬퍼가 추가되었습니다.
  • 2 새로 추가된 테스트 헬퍼는 `id`, `loading`, `source`, `target`과 같은 Turbo Frame의 주요 속성을 검증하며, 내부 콘텐츠에 대한 추가 검사를 위한 블록을 지원합니다.
  • 3 헬퍼의 정확한 동작을 보장하기 위해 `Minitest::Assertion` 예외 발생 여부를 확인하는 테스트 케이스를 포함하여 개발 및 검증 과정이 상세히 시연되었습니다.

도입

본 에피소드에서는 Ruby on Rails 애플리케이션에서 Turbo Frame을 활용한 통합 테스트를 보다 용이하게 수행할 수 있도록 Turbo Rails Gem에 새로운 테스트 헬퍼를 추가하는 과정을 다룹니다. 기존 `assert_turbo_stream`과 같은 Turbo Stream 관련 헬퍼는 존재했으나, Turbo Frame에 대한 직접적인 헬퍼가 부재하여 테스트 작성에 어려움이 있었습니다. 이에 `assert_turbo_frame` 및 `assert_no_turbo_frame` 헬퍼를 구현하여 응답 내 Turbo Frame의 존재 여부와 특정 속성들을 효과적으로 검증할 수 있는 방안을 제시합니다.

새로운 테스트 헬퍼는 Turbo Rails Gem의 포크를 생성하고 로컬 환경에서 개발되었습니다.

헬퍼 정의 및 테스트 전략

  • test_assertions 파일에 assert_turbo_frame 및 assert_no_turbo_frame 메서드 스켈레톤을 정의했습니다.
  • Minitest::Assertion 예외 발생 검증을 통해 헬퍼 신뢰성을 확보하는 테스트 전략을 수립했습니다.
  • 테스트 파일은 Turbo Frame을 렌더링하는 test/frames/frame_request_controller_test.rb로 선정되었습니다.

assert_turbo_frame 구현

  • ActionDispatch::IntegrationTest를 상속받는 TurboTestAssertionsFrameTest 클래스에 구현되었습니다.
  • 인수: id는 필수이며, loading, source, target은 선택적 속성 검증을 지원합니다.
  • 셀렉터: turbo-frame[id="ID"] 형태 등 동적으로 구성됩니다.
  • 검증: assert_selector로 요소 존재 및 속성을 확인하며, count는 기본적으로 1입니다.
  • 블록: Turbo Frame 내부 콘텐츠에 대한 추가 검사를 수행할 수 있습니다.
  • 일치하는 프레임에서 통과하고, 불일치 시 Minitest::Assertion을 발생시키는 테스트를 성공적으로 통과했습니다.

assert_no_turbo_frame 구현

  • assert_turbo_frame과 유사한 인수를 받습니다.
  • assert_selector를 사용하되, count를 0으로 설정하여 해당 Turbo Frame이 존재하지 않음을 검증합니다.
  • 요소 부재 확인이 목적이므로 블록은 필요하지 않습니다.
  • 일치하지 않는 프레임에서 통과하고, 일치 시 Minitest::Assertion을 발생시키는 테스트를 성공적으로 통과했습니다.

이 구현을 통해 Turbo Rails Gem에 더욱 완전한 테스트 헬퍼 세트가 추가되어, 개발자들이 Turbo Frame 기반의 동적 UI를 효과적으로 테스트할 수 있게 되었습니다.

결론

이 프로젝트는 Turbo Rails Gem에 `assert_turbo_frame` 및 `assert_no_turbo_frame` 테스트 헬퍼를 성공적으로 추가하여, 개발자들이 Turbo Frame을 활용한 복잡한 UI 로직(예: 무한 스크롤)을 통합 테스트에서 더욱 쉽고 강력하게 검증할 수 있도록 지원합니다. 특히 `id`, `loading`, `source`, `target`과 같은 핵심 속성들을 직접 검증하고, 블록을 통해 프레임 내부 콘텐츠까지 세밀하게 테스트할 수 있는 기능은 테스트 코드의 가독성과 유지보수성을 크게 향상시킬 것입니다. 이는 Turbo Rails 생태계를 더욱 견고하게 만들고, Hotwire 기반 애플리케이션 개발의 효율성을 높이는 데 기여할 것으로 기대됩니다.

관련 글들

Turbo를 활용한 폼 관리 및 프런트엔드 문제 해결 전략

Turbo Frames를 핵심으로 사용하여 페이지의 특정 영역만 업데이트함으로써, 전체 페이지 리로드 없이 일관된 사용자 경험을 제공합니다.

06/06 읽어보기 →

Hotwire Turbo 8의 '페이지 새로고침' 기능: 기존 Turbo Streams의 한계를 넘어

Hotwire Turbo 8의 새로운 '페이지 새로고침(Page Refreshes)' 기능은 스크롤 위치를 보존하며 효율적인 UI 업데이트를 가능하게 하여 기존 Turbo Streams의 복잡성을 줄입니다.

12/25 읽어보기 →

테스트 주도 개발: DAMP 원칙과 효과적인 테스트 전략

테스트는 'Arrange-Act-Assert' 패턴을 따르며, `let`이나 `described_class` 사용을 지양하여 자체 포함적이고 명확하게 작성해야 합니다.

08/11 읽어보기 →

Clip Show: 웹소켓 인증 개선, Kamal 배포 및 GitHub Actions CI/CD 구축 디버깅

테스트 환경의 복잡한 웹소켓 인증 문제를 `alert_token` 기반으로 리팩토링하고, React `useCallback` 훅을 활용하여 성능 저하 버그를 해결했습니다.

09/05 읽어보기 →

댓글 0

댓글 작성

0/1000
정중하고 건설적인 댓글을 작성해 주세요.

아직 댓글이 없습니다

첫 번째 댓글을 작성해보세요!