IntelliJ IDEA 2026.1 Help

Cypress

Cypress(英語) は、Web アプリケーション用のオープンソーステストフレームワークです。 開発者に、エンドツーエンドのテストを自動化するための高速で信頼性の高いソリューションを提供します。 Cypress は、その独自のアーキテクチャと包括的な機能セットにより、効率的なテスト作成、デバッグ、一般的なフレームワークや CI/CD パイプラインとの統合を可能にします。

新しい Cypress プロジェクトを作成する

  1. メインメニューで ファイル | 新規 | プロジェクト へ移動します。

    または、 ようこそ 画面を表示している場合は、 新規プロジェクト をクリックします。

  2. 左側のリストから Cypress を選択します。

    新しい Cypress プロジェクトの作成
  3. 新しいプロジェクトに名前を付け、必要に応じてその場所を変更します。

  4. Node.js ランタイム を指定します。

  5. パッケージマネージャー を指定します。

  6. 言語 リストから、使用する言語を選択します。

  7. (オプション) サンプルコードの追加 パラメーターを有効にします。

  8. (オプション) E2E テストの構成 パラメーターを有効にして、スペックファイルに適用されるカスタムコマンドまたはグローバルオーバーライドを導入するために使用されるサポートファイルのセットを作成します。

  9. (オプション) コンポーネントテストの構成 パラメーターを有効にして、コンポーネントテスト用のフレームワークをセットアップおよび構成します。 コンポーネントテストの構成 パラメーターを有効にしたら、リストから目的のフレームワークを選択します。

    コンポーネントテストを含む Cypress プロジェクトを作成する
  10. 作成 をクリックします。

選択したオプションに従って新しいプロジェクトが作成されます。

コードに要素を追加する

  1. 要素を追加するファイルを開きます。

  2. 右側のサイドバーの the Web Inspector button をクリックして、 Web インスペクター ツールバーウィンドウを開きます。

  3. アドレスバーにページの URL を指定します。

    アドレスバーコントロール
  4. The Select Element in Page button 」をクリックし、Web インスペクターで追加する要素を選択します。

    ページ内の要素を選択する
  5. 要素を選択したら、「Add Element to Code 」をクリックして要素をコードに追加します。

    「コードに要素を追加」ボタン

    特定のタイプのセレクター (ID名前クラスでタグ付けするなど) を追加するには、 Add Element to Code By をクリックして必要なオプションを選択します。

    コードに要素を追加する

    CSS ロケーターと XPath ロケーターの間で具体的に切り替える場合は、 をクリックして、必要なロケーター型を選択します。

    ロケーターのタイプを選択する

その結果、コードの一部が生成され、コードエディターに追加されます。

テストの実行

  • テストを実行するには、テストクラスまたはテストメソッドの横にある 実行ボタン ガターアイコンをクリックし、リストから 実行 オプションを選択します。

    テストの実行

    あるいは、キャレットをテストクラスに置いてそのクラス内のすべてのテストを実行するか、テストメソッドにキャレットを置き、 Ctrl+Shift+F10 を押します。

実行 / デバッグ構成を使用すると、よりカスタマイズ可能な方法でテストを実行できます。 詳細については、 テストの実行 を参照してください。

テスト結果を確認する

テストの実行が終了すると、結果が 実行 ツールウィンドウの テストランナー タブに表示されます。 このタブでは、テストの再実行、テスト結果のエクスポートとインポート、各テストの実行にかかった時間を確認したり、その他のアクションを実行したりできます。

実行ツールウィンドウのテストランナータブに表示されるテスト結果

詳細については、 テスト結果を調べる を参照してください。

デバッグテスト

実行 / デバッグ構成を変更する

テストの起動プロパティを変更する場合は、実行 / デバッグ構成を編集します。

  1. 実行 / デバッグ構成スイッチャーで現在の構成をクリックし、 構成の編集(R)… オプションを選択します。

    実行 / デバッグ構成を選択する
  2. 実行 / デバッグ構成 ダイアログで、編集する構成を選択します。

  3. 必要なスタートアッププロパティを構成します。

    起動プロパティの構成
  4. 変更を適用して OK をクリックします。

実行/デバッグ構成の詳細については、 実行 / デバッグ構成 を参照してください。

ロケーターテンプレートをカスタマイズする

選択した要素をコードに追加する方法をカスタマイズしたい場合は、テンプレートを変更できます。

  1. ステータスバーのフレームワーク名をクリックします。 UI オートメーションフレームワーク メニューが開きます。

    テンプレートのカスタマイズ
  2. テンプレートのカスタマイズ オプションを選択してください。

  3. ファイルおよびコードテンプレート ダイアログで、リストから必要なフレームワークを選択します。

    ファイルとコードのテンプレートダイアログ
  4. Web 要素ロケーターのコード生成アルゴリズムを書き換えます。

  5. 変更を保存するには、 OK をクリックします。

その結果、更新されたコード生成アルゴリズムに従ってロケーターがコードに追加されます。

Cypress Launchpad を開く

必要に応じて、現在のプロジェクトを Cypress ランチパッド(英語)で開くことができます。 これを行うには、 ⌘ ⌃ ] を押します。

Cypress ランチパッド
2026 年 3 月 30 日