Appium Vegaドライバーのロケーター戦略

​

サポートされている戦略

​

UiSelector

element = driver.find_element("UiSelector", '{"args": {"text": "要素のテキスト"}}')

element = driver.findElement(AppiumBy.ByAndroidUIAutomator.androidUIAutomator("{\"args\": {\"role\":\"edit\"} }"));

​

XPath

element = driver.find_element(by="xpath", value="//[contains(@description, \"Music\")]")

element = driver.findElement(AppiumBy.xpath("//[contains(@description, \"ミュージック\")]"));

const element = await driver.$('//[contains(@description, \"ミュージック\")]');

element = @driver.wait { |d| d.find_element :xpath, '//[contains(@description, \"ミュージック\")]' }

​

主な構成要素

1. 軸 - 子孫、祖先、後続など、検索の方向を指定します。
    // 子孫軸
    "//button"  // 子孫であるすべてのbutton
    "/button"   // 直下の子であるbutton
   
2. ノードテスト - 要素、属性、text()など、選択するノードタイプを指定します。
    "//*"           // 任意の要素
    "//button"      // button要素
    "//text()"      // テキストノード
   
3. 述部 - 属性値、位置、カスタム関数などのさまざまな条件に基づいて、選択されたノードをフィルタリングします。
   "//button[@text='ログイン']" // 完全一致
   "//button[contains(@text, 'ログイン')]" // 部分一致
   

​

特殊なユースケース

// ルート要素
driver.findElement(By.xpath("/root"));

// 説明による要素の選択
driver.findElement(By.xpath("//*[contains(@description, 'ミュージック')]"));

// 複雑な階層の選択
driver.findElement(By.xpath("//parent/*[2]//child[@visible='true']"));

​

セレクター戦略の比較

​

ベストプラクティス

1. 適切な戦略の選択
   • プラットフォーム固有のテストにはUiSelectorを使用します。
   • クロスプラットフォームの互換性が求められる場合はXPathを使用します。
   • パフォーマンスが重要な場合はUiSelectorを選択します。
2. 要素の特定
   • 可能な場合は一意の識別子を使用します。
   • 絶対パスを使用しないようにします。
   • セレクターはできるだけシンプルにします。
   • セレクターの信頼性を定期的に検証します。
3. パフォーマンスに関する考慮事項
   • 複雑なXPathクエリはテストの実行時間に影響する可能性があります。
   • 頻繁に使用する要素をキャッシュします。
   • 可能な場合はアプリ固有のIDを使用します。
4. メンテナンスに関するヒント
   • ロケーター戦略を文書化します。
   • ロケーターを定期的に確認します。
   • UIの変更に合わせて更新を行います。
   • クロスプラットフォームの互換性を保ちます。
   • テストコードで意味のわかる名前を使用します。