Cypress は、Web アプリケーションのエンドツーエンドのテストを簡素化する人気のテスト フレームワークです。 Cypress で使用するコア コマンドの 1 つは、[cypress run](https://keploy.io/blog/community/comprehensive-guide-to-running-tests-with-cypress) です。このコマンドを使用すると、ヘッドレス環(huán)境でテストを?qū)g行できるため、継続的な統(tǒng)合とテストのワークフローに最適です。この投稿では、cypress run コマンドを効果的に使用し、その可能性を最大限に引き出す方法を探っていきます。

プロジェクトでの Cypress のセットアップ

cypress run を使用する前に、まずプロジェクトに Cypress をインストールする必要があります。 Cypress をまだセットアップしていない場合は、簡単に始めることができます。次のコマンドを?qū)g行するだけです:

bash
Copy code
npm install cypress --save-dev

このコマンドは、Cypress を開発依存関係としてプロジェクトにインストールします。インストールしたら、npx cypress open を使用して Cypress を開いてテストの作成を開始できます。ただし、ヘッドレス ブラウザー (GUI なし) でテストを?qū)g行する場合は、cypress run コマンドを使用します。

「cypress run」によるテストの実行

cypress run コマンドは、ヘッドレス環(huán)境でテストを?qū)g行する最も簡単な方法です。すべてのテストを?qū)g行するには、次を?qū)g行するだけです:

bash
Copy code
npx cypress run

これにより、ヘッドレス ブラウザ (通常は Electron) を使用して、デフォルトで /cypress/integration フォルダーにあるすべてのテストが実行されます。テストはバックグラウンドで実行され、結(jié)果がターミナルに表示されます。

特定のテスト ファイルの実行

すべてのテストではなく、特定のテスト ファイルを?qū)g行したい場合があります。これは、特定の機(jī)能に取り組んだり、単一のテストをデバッグしたりする場合に特に便利です。 --spec フラグの後にテスト ファイルへのパスを指定することができます:

bash
Copy code
npx cypress run --spec cypress/integration/example.spec.js

このコマンドは、指定されたファイル內(nèi)のテストのみを?qū)g行するため、反復(fù)を高速化できます。

テスト実行用のブラウザの選択

サイプレスは、Chrome、Firefox、Electron などのさまざまなブラウザをサポートしています。デフォルトでは、Cypress は Electron でテストを?qū)g行します。ただし、--browser フラグの後にブラウザ名を渡すことで、使用するブラウザを選択できます:

bash
Copy code
npx cypress run --browser chrome

このコマンドは Chrome でテストを?qū)g行します。 Firefox などの他のサポートされているブラウザを指定することもできます:

bash
Copy code
npx cypress run --browser firefox

この柔軟性により、アプリケーションがさまざまなブラウザ環(huán)境でテストされ、ブラウザ間の互換性が確保されます。

テスト結(jié)果の記録

サイプレスは、詳細(xì)なテスト結(jié)果を記録および表示できるサイプレス ダッシュボードと呼ばれる機(jī)能を提供します。テスト結(jié)果を記録するには、--record フラグを使用する必要があります:

bash
Copy code
npm install cypress --save-dev

--record フラグを使用すると、Cypress はテスト結(jié)果を Cypress ダッシュボードに自動(dòng)的にアップロードし、テストのログ、スクリーンショット、ビデオを表示できます。

テストをダッシュ??ボードのプロジェクトにリンクするには、Cypress ダッシュボード アカウントでプロジェクトを設(shè)定し、次のようにプロジェクトのレコード キーを指定する必要があります。

bash
Copy code
npx cypress run

テストを記録すると、テスト履歴を追跡し、失敗や不安定なテストについての洞察を得るのに役立ちます。

テストのグループ化と並列化

大規(guī)模なテスト スイートを扱う場合、すべてのテストを順番に実行すると時(shí)間がかかることがあります。 Cypress は、テストをグループ化して並列化する機(jī)能を提供し、複數(shù)のマシン間で同時(shí)に実行できるようにします。

--group フラグを使用してテストをグループ化できます。

bash
Copy code
npx cypress run --spec cypress/integration/example.spec.js

さらに、--Parallel フラグを使用してテストを並列実行して、実行を高速化することができます。

bash
Copy code
npx cypress run --browser chrome

テストを並列化すると、多數(shù)のテストの実行にかかる時(shí)間を大幅に短縮できます。これは継続的インテグレーション パイプラインにとって重要です。

環(huán)境変數(shù)の構(gòu)成

Cypress では、環(huán)境変數(shù)を構(gòu)成して、さまざまな環(huán)境に基づいてテストの動(dòng)作を変更できます。 --env オプションを使用して環(huán)境変數(shù)を Cypress に渡すことができます:

bash
Copy code
npx cypress run --browser firefox

このコマンドは apiUrl 変數(shù)と env 変數(shù)を設(shè)定します。これらの変數(shù)には、Cypress.env('apiUrl') を使用してテスト內(nèi)でアクセスできます。この機(jī)能は、テストの実行中に異なる環(huán)境 (ステージング、本番環(huán)境など) を切り替える必要がある場合に役立ちます。

テストの失敗と再試行の処理

場合によっては、タイミングの問題や外部依存関係により、テストが斷続的に失敗することがあります。テストの信頼性を向上させるために、サイプレスでは失敗したテストを再試行するオプションを提供しています。

--retries フラグを使用して再試行の回?cái)?shù)を指定できます。

bash
Copy code
npx cypress run --record

このコマンドは、失敗したテストを最大 2 回再試行します。これにより、不安定なテストの影響が軽減され、より安定したテスト結(jié)果が保証されます。

「cypress run」を CI/CD パイプラインに統(tǒng)合する

cypress run コマンドを継続的インテグレーションおよび継続的デリバリー (CI/CD) パイプラインに統(tǒng)合することは、テスト プロセスを自動(dòng)化するために重要です。 Jenkins、CircleCI、GitHub Actions、GitLab CI などの一般的な CI ツールは、Cypress テストの実行をサポートしています。

ここでは、GitHub Actions を使用して Cypress テストを?qū)g行するための基本的な CI パイプラインを構(gòu)成する方法の例を示します。

bash
Copy code
npx cypress run --record --key <your-dashboard-project-key>

この構(gòu)成では、依存関係をインストールし、ヘッドレス ブラウザーで Cypress テストを?qū)g行します。また、テスト結(jié)果は Cypress ダッシュボードに記録されます。

結(jié)論

cypress run コマンドをマスターすると、開発者はテストを効率的に実行し、結(jié)果を記録し、複數(shù)の環(huán)境にわたってテストを拡張できるようになります。単一のテスト ファイルを?qū)g行する場合でも、何百ものテストを並列処理する場合でも、サイプレスはテスト ワークフローを合理化するために必要なツールを提供します。 cypress run を CI/CD パイプラインに組み込むことで、アプリケーションが常にテストされ、デプロイの準(zhǔn)備が整っていることを確認(rèn)できます。

以上がCypress run は人気のあるテスト フレームワークですの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。