Preferred Native Appium Selectors for WebdriverIO

selectors.js

// The `~` tells WebdriverIO that it needs to look for an accessibiltyID
// Android: `content description`
// iOS: `accessibility id`
$('~accessibiltyID').click();

// -ios predicate string
const loginButton = 'type == \'XCUIElementTypeOther\' && name CONTAINS \'test-LOGIN\'';
$(`-ios predicate string:${ loginButton }`).click();

// -ios class chain, to make complex selectors
const classChainSwagItem = '**/XCUIElementTypeOther[`name CONTAINS "test-Item"`]/**/XCUIElementTypeOther[`name CONTAINS "Sauce Labs Bike Light" AND name CONTAINS "ADD TO CART"`]/**/XCUIElementTypeOther[`name == "test-ADD TO CART"`]';
$(`-ios class chain:${ classChainSwagItem }`).click();

// -android uiautomator
const androidButton = 'new UiSelector().text("Cancel").className("android.widget.Button")';
$(`android=${androidButton}`).click();

// className for iOS
$('UIATextField').click();
// className for Android
$('android.widget.DatePicker').click();

// XPATH
const xpathSwagItem = '//XCUIElementTypeStaticText[contains(@value,"Sauce Labs Bike Light")]//ancestor::*[@name="test-Item"]//*[@name="test-ADD TO CART"]';
$(xpathSwagItem).click();