Discourse 코어, 플러그인 및 테마의 QUnit 테스트 스위트 실행 방법

Discourse는 코어, 플러그인, 테마에 대한 광범위한 프론트엔드 테스트를 갖추고 있습니다. 로컬 개발 환경이 정상적으로 구성되면 이러한 테스트를 다양한 방법으로 로컬에서 실행할 수 있습니다.

브라우저에서 테스트 실행

코어 / 플러그인: 개발 환경에서 /tests 페이지로 이동

테마: 개발(또는 프로덕션) 환경에서 /theme-qunit 페이지로 이동한 후 테마를 선택

일반적으로 코어 테스트를 작업할 때는 “Target” 드롭다운에서 "core"를 선택하고, 플러그인을 작업할 때는 특정 플러그인을 선택해야 합니다.

:information_source: 불행하게도, 현재 기준으로는 테스트의 메모리 누수 문제로 인해 전체 테스트 스위트를 단일 브라우저에서 실행하려고 하면 브라우저 메모리 제한에 도달하기 쉽습니다. 전체 스위트를 여러 브라우저에서 병렬로 실행하려면 아래 CLI 예를 확인하세요.

CLI에서 테스트 실행

코어

Discourse의 루트 디렉터리에서 bin/qunit을 사용하세요 (마지막으로 상류(upstream) 변경 사항을 가져온 이후 pnpm install을 실행했는지 확인하세요). 이 스크립트는 무작위화 및 병렬화를 위해 Ember Exam을 래핑하며, 기본적으로 실행 중인 Rails 서버와 기존 JS 에셋을 대상으로 실행됩니다. 전체 옵션 목록은 bin/qunit --help를 실행하여 확인할 수 있습니다.

유용한 예시 몇 가지는 다음과 같습니다:

# 단일 테스트 파일 또는 디렉터리의 모든 테스트 실행:
bin/qunit frontend/discourse/tests/integration/components/bookmark-test.gjs
bin/qunit frontend/discourse/tests/integration/components

# 전체 코어 스위트를 5개의 헤드리스 Chrome 인스턴스에서 병렬로 실행:
bin/qunit --parallel 5

# "모듈: 테스트 이름"에 부분 문자열이 포함된 모든 테스트 실행(대소문자 무시):
bin/qunit --filter "Integration | Component | bookmark"

# 값에 슬래시를 감싸 정규식으로 매칭, 예를 들어 대안(alternation)을 위한 경우:
bin/qunit --filter "/bookmark|reaction/i"

# 격리된 서버를 시작하고 보기 쉬운 디버깅을 위해 가시적 브라우저에서 실행:
bin/qunit --standalone --no-headless

:information_source: --filter는 QUnit으로 전달됩니다: 일반 값은 대소문자를 무시하는 부분 문자열로 매칭되며, /foo/i처럼 슬래시로 감싼 값은 정규식으로 매칭됩니다. 대소문자를 무시하는 정규식 매칭을 위해 i 플래그를 포함하세요.

플러그인

Discourse의 루트 디렉터리에서:

bin/qunit plugins/chat/test/javascripts/unit/lib/chat-audio-test.js # 단일 파일 실행
bin/qunit plugins/chat/test/javascripts/unit # 디렉터리 실행
bin/rake "plugin:qunit" # 모든 플러그인 qunit 테스트 실행
bin/rake "plugin:qunit[discourse-chat-integration]" # 단일 플러그인의 qunit 테스트 실행

테마

Discourse의 루트 디렉터리에서:

bin/rake "themes:qunit[url,<theme_url>]"
bin/rake "themes:qunit[name,<theme_name>]"
bin/rake "themes:qunit[id,<theme_id>]"

이 문서는 버전 관리를 통해 관리됩니다 - github에서 변경 사항을 제안하세요.

20개의 좋아요