ビジュアルアサーション

要素がある、消えた、または指定した回数だけあることを確かめます。

ビジュアルアサーションの仕組み

ビジュアルアサーションは、要素の小さな画像、つまりビジュアルターゲットを持っています: ボタン、アイコン、フィールド、ロゴなどです。テストの実行中、GTS Engine + AI は実際の画面上でその要素を見つけ (まずアプリケーションのアクセシビリティ情報を通じて場所を尋ね、アプリケーションが答えないときは見た目で探します)、画像と比較します。

自分のアプリ検索範囲Save

1. 検索

2. 比較

期待

Save

記録した内容

今回見つかった位置

Save

実際の画面上で

同じ要素、同じ見た目: 合格

すべてのビジュアルアサーションは 2 つのステップで動作します。テストの実行中、GTS Engine はアプリのアクセシビリティ情報または見た目によって、検索範囲内のどこにあっても要素を見つけます。次に、見つけたものを記録した画像と比較し、無害なノイズは無視して本当のリグレッションを検出します。

この比較は賢いものです: 画面が前回より少し明るく描画されたり、縁が少し柔らかくなったりしただけでテストを不合格にはしません。人が見て違いに気づくときには、不合格にします。

Sign inSign in少しやわらかいエッジ、少し明るい色合い合格
Sign inSign In文字の大文字と小文字が変わった不合格
Total: 42Total: 43数字が 1 桁変わった不合格
GTS Engine は、実行のたびにどの画面にも生じるごく小さな違いを無視し、人がバグと呼ぶ変化を検出します。

ビジュアルアサーション

要素が画面上にあり、正しい見た目であることを検証します。記録が各クリックの前に作るアサーションで、最もよく使われるアサーションです。

例「保存」をクリックする前に

クリックの直前に置かれた「保存」ボタンのビジュアルアサーション: 実行はボタンが表示されるまで待ち、正しいボタンであることを確かめてから、初めてクリックします。ボタンが現れない、または見た目が違う場合、テストはそこで停止し、レポートがその理由を示します。

探すものを指定する

  1. 1

    アサーションを選択して「ビジュアルターゲットを編集」をクリックする

    ビジュアルターゲットエディターが、その時点の記録のフレームで開きます。別の時点からビジュアルターゲットを切り出すには、別のフレームを使用...をクリックしてください。表示中のフレームがアサーション自身のものでない間、その行は琥珀色になります。

  2. 2

    要素を囲む四角形を描く

    検証したい要素の縁より少し外側を囲むように、四角形をドラッグして描きます。中央をつかんで移動、ハンドルでサイズ変更、方向キーで微調整ができます。コンテンツファイルから画像をドラッグして入れることも、画面からキャプチャすることもできます。

  3. 3

    検索範囲を確認する

    破線の四角形が検索範囲です: 実行が要素を探す場所です。ビジュアルターゲットを移動すると一緒に動き、南京錠をクリックするとその場に固定されます。下記をご覧ください。

  4. 4

    適用

    「プロパティ」パネルにビジュアルターゲットが表示されます。

検索範囲

記録検索範囲Save次の実行Save少し動いた: それでも見つかる
検索範囲は、テストが要素を探す場所です。要素が少し動いても、範囲の中にとどまっていれば見つかります。あちこち動く要素には範囲を広げ、どこにあるかわからない要素には「画面全体を検索」をオンにしてください。

ビジュアル不在アサーション

要素が消えるまで待ちます: スピナー、「お待ちください」のバナー、閉じるべきダイアログなどです。要素がしばらく消えたままになれば合格し、時間切れになってもまだ画面上にあれば不合格になります。

例推測ではなく、スピナーを待つ

「レポートを生成」をクリックすると、スピナーが 2 ~ 20 秒回ります。タイムアウト 30 秒のビジュアル不在アサーションをスピナーに置けば、レポートができた瞬間にテストが先へ進めます: 固定の待機も、無駄な時間もありません。

ビジュアルカウントアサーション

要素が画面上に何回あるかを数え、その合計をルールに照らします。

Invoice 2041Paid1
Invoice 2042Paid2
Invoice 2043Paid3

3 件見つかりました

ルール: ちょうど 3 · 成立

カウントアサーションは、要素が表示されている場所をすべて見つけて番号を付け、その合計をルール (ちょうど、以上、以下、または 2 つの数の間) に照らして判定します。
ルール例
ちょうど評価の星がちょうど 5 個
以上検索結果が 1 件以上
以下エラーアイコンが 0 個以下
~から~までカート内の商品が 2 個から 4 個まで

エディターでは、要素が見つかったすべての場所にフレーム上で番号が付き、その下の行がそのフレームでルールが成り立つかどうかを示します: 実行する前に結果が分かります。

比較の厳密さ

各ビジュアルアサーションには検証の厳密さがあります。ほとんどの場合は「標準」が適切です。

厳密さ用途
完全1 ピクセルも変わってはいけない画像。
厳密どんな変化も問題になる、小さな文字や細部。
標準日常的なボタン、ラベル、アイコン。既定の値です。
緩和ページ全体やゲームの場面など、広い領域や情報の多い画面。

色を無視は、色にかかわらず形だけを検証します: テーマによって、テストしたくない色が変わるときに便利です。

クリックは要素を追いかける

ビジュアルアサーションが要素を記録時とは別の場所で見つけた場合、その後のクリックは、以前の場所ではなく、要素が今ある場所に向けられます。小さなレイアウトの変化で、クリックが何もない場所へ飛ぶことはありません。

例移動したボタン

新しいバナーがページを 40 ピクセル押し下げます。アサーションは「保存」ボタンを 40 ピクセル下で見つけ、その後のクリックはボタンの上に着地します。

テキストアサーションもマウスを要素へ移動オプションで同じことができます: アサーションの後のクリックは、見つけたテキストに向けられます。

タイムアウト、検索範囲、失敗もご覧ください。

まだ解決しませんか?何をしようとしていたかをお知らせください。1 営業日以内に回答します。Ask our team