Documentation Index

Fetch the complete documentation index at: https://helpcenter.autify.com/llms.txt

Use this file to discover all available pages before exploring further.

ビジュアルアサーション

Prev Next

※ このトピックの一部は機械翻訳で処理されています。

ビジュアルアサーション (ビジュアルリグレッションテストとも呼ばれます) は、スクリーンショットを使用してテスト実行全体の UI の変更を検出するために使用されます。つまり、Autify Nexusは、Webサイトの特定の部分が録画時や前回のテスト成功時と異なって見えるかどうかを判断できます。

ビジュアルアサーション・ステップの記録

ビジュアルアサーションを記録するには、記録時に次のいずれかのアクションを選択します。

  • ページの表示変更をアサートする (ページ アサーション)

  • 同じように見えます(要素アサーション)

差分しきい値(%)

差分しきい値は、テスト実行間のターゲットの許容可能な変化のしきい値 (ピクセル単位の差) を設定します。しきい値を超える変更を行うと、アサーションは失敗します。0%は非常に厳密で、ピクセル単位で完全一致するテストを意味します。100%は、ターゲットへのすべての変更を受け入れます。

失敗したアサーションの正しいしきい値の設定

コンピュータのハードウェアとソフトウェアの設定、およびテスト実行中に使用するウィンドウ サイズによっては、記録後に実行する最初のテストでビジュアル アサーションが合格しない場合があります。簡単にするために、Autify Nexusが推奨するスクリーンショットを使用して、失敗したテストの詳細なテスト結果基準画像を更新する をクリックします。このスクリーンショットを使用する場合、アサーションのしきい値を調整する必要はありません。その後のテストは、ターゲットにそれ以上の変更がない限り、合格します。

UI の小さな変更、テスト環境間でのレンダリングのわずかな違いが予想される場合、または複雑な要素に対してアサーションを安定させる場合は、適切なレベルが見つかるまで、しきい値を 1 から 5% ずつ増やしてみてください。


FAQ

「見た目が同じ」アサーションと「ページの見た目が同じであることを確認する」アサーションはどう使い分ければいいですか?

「見た目が同じ」アサーション(要素アサーション) では、指定した特定の要素の見た目が変わっていないことを検証します。一方、「ページの見た目が同じであることを確認する」アサーション(ページアサーション)では、ページ全体の見た目が変わっていないことを検証します。

使い分けの目安は以下のとおりです。

  • 「見た目が同じ」が適しているケース

    • ページ内の特定要素の見た目が期待通りかを確認したい場合

    • アクセスのたびに表示内容が変わる動的なページで、変動しない特定要素のみを対象に検証したい場合

  • 「ページの見た目が同じであることを確認する」が適しているケース

    • ページ全体のレイアウトや表示が期待通りかを確認したい場合

ローカル環境とクラウドの実行環境など実行環境によっては、テキストを含む画像比較 (ビジュアルアサーション) ステップで微細な差異が生じ、テストが失敗するのはなぜですか?

実行環境によっては、OSの違いによるフォントの描画やレンダリング方式が異なるため、テキストを含む画像比較において微細な差異が生じます。以下の方法をご検討ください。

  • テキストアサーションへの変更

    • 文字情報の整合性を確認することが主目的である場合は、画像比較ではなく、テキストの内容自体を検証するアサーションへの変更を推奨いたします。

  • 閾値の調整

    • 微細な差異を許容できるよう、比較の閾値を引き上げて調整いただく方法がございます。

  • 実行環境ごとのシナリオ分割

    • クラウド実行用とローカル実行用でシナリオを分け、それぞれの環境に適した期待値(スクリーンショット)を管理・運用する方法も有効です。なお、クラウド実行時は利用端末にインストールされているフォントファミリーにご期待のフォントが含まれていない場合、意図しないフォントで表示される可能性があります。フォントを指定したり、ご期待のフォントで表示されていること自体の検証はできません。