開発チームが data-qaid、data-cy、formcontrolname などのカスタム属性で要素をマークしている場合、mabl はそれらの属性をテスト内の要素の識別に使用できるようになりました。ウェブアプリケーションにカスタムテスト ID 属性を設定することで、mabl はチームがアプリの構築に使用している既存のコーディング標準に適応できます。
アプリがカスタムテスト ID 属性を使用している場合、mabl でそれらを設定することで得られるメリットは次のとおりです。
- 検索の設定と CSS/XPath への依存を軽減できるため、最初からより堅牢な検索をトレーニングできます。
- 検索の設定をより活用できます。カスタム属性が mabl の組み込み属性と並んで表示されます。
- 自動修復の精度を向上できます。検索モデルが、開発チームが安定していると見なす属性を基準として使用できるためです。
- エージェントによるテスト作成の精度を向上できます。mabl エージェントが新しいステップを作成する際に、カスタム属性をプライマリセレクターとして使用するためです。
試してみる
ウェブアプリのカスタムテスト属性を設定するには、テスト環境設定 > アプリケーションに移動し、更新するアプリケーションを開きます。
カスタムテスト ID 属性はウェブアプリケーションにのみ適用されます。
詳細設定セクションで、カスタムテスト ID 属性フィールドに属性名を入力します。たとえば、data-qaid、data-cy、data-automation-id などです。アプリケーションごとに最大 3 つの属性を設定できます。
ウェブアプリが id などの属性を使用して要素を一意に識別している場合は、それらも追加できます。追加する属性がウェブアプリ内の要素を確実に識別できることを確認してください。そうでない場合、検索プロセスが複雑になる可能性があります。
仕組み
mabl がステップの検索をキャプチャする際、Trainer での手動トレーニング、エージェントによるテスト作成、または再トレーニングのいずれの場合でも、アプリケーションに設定されたカスタムテスト ID 属性を確認するようになりました。設定された属性がターゲット要素に存在する場合、mabl はその値を保存し、以降の実行でその要素を特定する際のプライマリ識別子として扱います。
既存のテストは、ステップが再トレーニングされるまで新しい設定を反映しません。設定済みの属性を持つ要素に対してステップをトレーニングまたは再トレーニングすると、mabl はその属性を検索モデルの一部としてキャプチャします。
検索ステップを編集すると、設定済みの属性が検索詳細の上部にある新しいカスタム ID セクションに表示されます。
設定済みの属性が要素に存在しない場合、またはカスタム ID を使用して要素が見つからない場合、mabl は name、title、innerText などの組み込み属性を含む標準の検索モデルにフォールバックします。