Discourseのコア、プラグイン、テーマのQUnitテストスイートを実行する方法

Discourseには、コア、プラグイン、テーマ用の広範なフロントエンドテストがあります。ローカル開発環境が正常に動作するようになれば、これらのテストをさまざまな方法でローカルで実行できます。

ブラウザでテストを実行する

コア / プラグイン: 開発環境で /tests にアクセスします

テーマ: 開発環境(または本番環境)で /theme-qunit にアクセスし、テーマを選択します

一般的に、コアのテストに取り組む際は「Target」ドロップダウンメニューから「core」を選択し、プラグインのテストに取り組む際は特定のプラグインを選択してください。

:information_source: 残念なことに、執筆時点では、テスト中のメモリリークにより、全体のテストスイートを1つのブラウザで実行しようとするとブラウザのメモリ制限に達することがあります。複数のブラウザで並列に全体のテストスイートを実行するには、下記のCLIの例を確認してください。

CLIでテストを実行する

コア

Discourseのルートディレクトリから bin/qunit を使用します(上流の変更を最後に取得して以来、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

# "module: test name"に部分文字列(大文字小文字を区別しない)を含むすべてのテストを実行:
bin/qunit --filter "Integration | Component | bookmark"

# 値をスラッシュで囲んで正規表現で一致させる、例えば代替(|)を使う場合:
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 # 1つのファイルを実行
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