Docs » Troubleshoot broken tests

Troubleshoot broken tests 🔗

There are a number of reasons why your tests might fail like issues with test validation or application unresponsiveness. For example,

  • API endpoint was unreachable

  • URL was unreachable

  • UI element wasn’t found

  • Default wait time of 10 seconds is too short for step assertions to complete. A test might fail because it takes longer than 10 seconds for a website to load.

Troubleshoot test validation 🔗

以下のガイドラインに従って、故障したテストのトラブルシューティングを行ってください。

  1. (オプション) オリジナルのテストを修正する前に様々な解決策をチェックできるように、テストのコピーを作成します。

  2. テストページを開き、テストがいつ失敗し始めたかを確認します。以下の質問を考えてみてください:

    • チェックに失敗したのはいつですか?他の失敗した実行にパターンはありますか?

    • チェックは同じステップで一貫して失敗しますか、それとも断続的に失敗しますか?

    • このステップでチェックが失敗したのは初めてですか?テストに最近変更を加えましたか?

    • 障害は特定の場所に関連したものですか、それともすべての場所にまたがるものですか?

  3. 失敗したテストの実行結果ビューを開き、失敗しているステップを見つけてリンクに移動します。

  4. inspect要素を開きます。

  5. ステップを複製し、壊れたステップを見つけるまでテストのステップを繰り返します。

  6. テストで使用したいセレクターのインスタンスが1つだけであることを確認してください。セレクターが複数回出現すると、将来的にテストが再び壊れる可能性があります。一意なセレクターは、テストのパフォーマンスを最適化します。

  7. 調査結果でテストを更新します。

This page was last updated on 2024年07月02日.