How to use iOSClassChain method of io.appium.java_client.AppiumBy class

...52        return new ByAccessibilityId(accessibilityId);53    }54    /**55     * This locator strategy is available in XCUITest Driver mode.56     * @deprecated Use {@link AppiumBy#iOSClassChain(String)} instead.57     * @param iOSClassChainString is a valid class chain locator string.58     *                            See <a href="https://github.com/facebookarchive/WebDriverAgent/wiki/Class-Chain-Queries-Construction-Rules">59     *                            the documentation</a> for more details60     * @return an instance of {@link ByIosClassChain}61     */62    @Deprecated63    public static By iOSClassChain(final String iOSClassChainString) {64        return new ByIosClassChain(iOSClassChainString);65    }66    /**67     * This locator strategy is only available in Espresso Driver mode.68     * @deprecated Use {@link AppiumBy#androidDataMatcher(String)} instead.69     * @param dataMatcherString is a valid json string detailing hamcrest matcher for Espresso onData().70     *                            See <a href="http://appium.io/docs/en/writing-running-appium/android/espresso-datamatcher-selector/">71     *                            the documentation</a> for more details72     * @return an instance of {@link ByAndroidDataMatcher}73     */74    @Deprecated75    public static By androidDataMatcher(final String dataMatcherString) {76        return new ByAndroidDataMatcher(dataMatcherString);77    }78    /**...

...143        return new ByImage(b64Template);144    }145    /**146     * This locator strategy is available in XCUITest Driver mode.147     * @param iOSClassChainString is a valid class chain locator string.148     *                            See <a href="https://github.com/facebookarchive/WebDriverAgent/wiki/Class-Chain-Queries-Construction-Rules">149     *                            the documentation</a> for more details150     * @return an instance of {@link AppiumBy.ByIosClassChain}151     */152    public static By iOSClassChain(final String iOSClassChainString) {153        return new ByIosClassChain(iOSClassChainString);154    }155    /**156     * This locator strategy is available in XCUITest Driver mode.157     * @param iOSNsPredicateString is an iOS NsPredicate String158     * @return an instance of {@link AppiumBy.ByIosNsPredicate}159     */160    public static By iOSNsPredicateString(final String iOSNsPredicateString) {161        return new ByIosNsPredicate(iOSNsPredicateString);162    }163    public static class ByAccessibilityId extends AppiumBy implements Serializable {164        public ByAccessibilityId(String accessibilityId) {165            super("accessibility id", accessibilityId, "accessibilityId");166        }167    }168    public static class ByAndroidDataMatcher extends AppiumBy implements Serializable {169        protected ByAndroidDataMatcher(String locatorString) {170            super("-android datamatcher", locatorString, "androidDataMatcher");171        }172    }173    public static class ByAndroidUIAutomator extends AppiumBy implements Serializable {174        public ByAndroidUIAutomator(String uiautomatorText) {175            super("-android uiautomator", uiautomatorText, "androidUIAutomator");176        }177    }178    public static class ByAndroidViewMatcher extends AppiumBy implements Serializable {179        protected ByAndroidViewMatcher(String locatorString) {180            super("-android viewmatcher", locatorString, "androidViewMatcher");181        }182    }183    public static class ByAndroidViewTag extends AppiumBy implements Serializable {184        public ByAndroidViewTag(String tag) {185            super("-android viewtag", tag, "androidViewTag");186        }187    }188    public static class ById extends AppiumBy implements Serializable {189        protected ById(String selector) {190            super("id", selector, "id");191        }192    }193    public static class ByName extends AppiumBy implements Serializable {194        protected ByName(String selector) {195            super("name", selector, "name");196        }197    }198    public static class ByClassName extends AppiumBy implements Serializable {199        protected ByClassName(String selector) {200            super("class name", selector, "className");201        }202    }203    public static class ByCustom extends AppiumBy implements Serializable {204        protected ByCustom(String selector) {205            super("-custom", selector, "custom");206        }207    }208    public static class ByImage extends AppiumBy implements Serializable {209        protected ByImage(String b64Template) {210            super("-image", b64Template, "image");211        }212    }213    public static class ByIosClassChain extends AppiumBy implements Serializable {214        protected ByIosClassChain(String locatorString) {215            super("-ios class chain", locatorString, "iOSClassChain");216        }217    }218    public static class ByIosNsPredicate extends AppiumBy implements Serializable {219        protected ByIosNsPredicate(String locatorString) {220            super("-ios predicate string", locatorString, "iOSNsPredicate");221        }222    }223}...

...88        @Override By getBy(Annotation annotation) {89            return MobileBy.windowsAutomation(getValue(annotation, this));90        }91    },92    BY_CLASS_CHAIN("iOSClassChain") {93        @Override By getBy(Annotation annotation) {94            return AppiumBy95                    .iOSClassChain(getValue(annotation, this));96        }97    },98    BY_DATA_MATCHER("androidDataMatcher") {99        @Override By getBy(Annotation annotation) {100            return AppiumBy101                    .androidDataMatcher(getValue(annotation, this));102        }103    },104    BY_VIEW_MATCHER("androidViewMatcher") {105        @Override By getBy(Annotation annotation) {106            return AppiumBy107                .androidViewMatcher(getValue(annotation, this));108        }109    },...

...42    {43        @Override44        public By buildBy(String value)45        {46            return AppiumBy.iOSClassChain(value);47        }48    },49    ID("Id", ByLocatorSearch.class)50    {51        @Override52        public By buildBy(String value)53        {54            return By.id(value);55        }56    },57    TEXT_PART("Text part", GenericTextFilter.class),58    TEXT("Text", GenericTextFilter.class),59    ATTRIBUTE("Attribute", ElementAttributeFilter.class);60    private final String attributeName;...

...35                .size(), 0);36    }37    @Test public void findByByIosClassChainTest() {38        assertNotEquals(driver39                .findElement(AppiumBy.iOSClassChain("**/XCUIElementTypeButton"))40                .getText(), null);41        assertNotEquals(driver42                .findElements(AppiumBy.iOSClassChain("**/XCUIElementTypeButton"))43                .size(), 0);44    }45}...

1import io.appium.java_client.AppiumDriver;2import io.appium.java_client.MobileElement;3import io.appium.java_client.ios.IOSDriver;4import io.appium.java_client.remote.MobileCapabilityType;5import org.openqa.selenium.remote.DesiredCapabilities;6import java.net.MalformedURLException;7import java.net.URL;8public class AppiumClassChain {9    public static void main(String[] args) throws MalformedURLException, InterruptedException {10        DesiredCapabilities caps = new DesiredCapabilities();11        caps.setCapability(MobileCapabilityType.DEVICE_NAME, "iPhone 6");12        caps.setCapability(MobileCapabilityType.PLATFORM_NAME, "iOS");13        caps.setCapability(MobileCapabilityType.PLATFORM_VERSION, "11.2");14        caps.setCapability(MobileCapabilityType.AUTOMATION_NAME, "XCUITest");15        caps.setCapability(MobileCapabilityType.APP, "/Users/ashishkumar1/Desktop/testapp.app");16        caps.setCapability(MobileCapabilityType.NEW_COMMAND_TIMEOUT, 1000);

1import java.net.MalformedURLException;2import java.net.URL;3import org.openqa.selenium.By;4import org.openqa.selenium.WebElement;5import org.openqa.selenium.remote.DesiredCapabilities;6import io.appium.java_client.AppiumDriver;7import io.appium.java_client.MobileElement;8import io.appium.java_client.ios.IOSDriver;9public class ClassChain {10    public static void main(String[] args) throws MalformedURLException {11        DesiredCapabilities caps = new DesiredCapabilities();12        caps.setCapability("platformName", "iOS");13        caps.setCapability("platformVersion", "13.3");14        caps.setCapability("deviceName", "iPhone 11");15        caps.setCapability("automationName", "XCUITest");16        caps.setCapability("app", "/Users/username/Library/Developer/Xcode/DerivedData/Calculator-abcde/Build/Products/Debug-iphonesimulator/Calculator.app");17        caps.setCapability("noReset", true);18        By by = AppiumBy.iOSClassChain("**/XCUIElementTypeButton[`label == '3'`]");19        WebElement element = driver.findElement(by);20        element.click();21    }22}23    {24        caps: {25        },26        appium_lib: {27        }28    }29Appium::Driver.new(caps, true)30by = Appium::Core::Base::SearchContext.ios_class_chain("**/XCUIElementTypeButton[`label == '3'`]")

1import io.appium.java_client.AppiumDriver;2import io.appium.java_client.ios.IOSDriver;3import io.appium.java_client.remote.MobileCapabilityType;4import io.appium.java_client.MobileElement;5import io.appium.java_client.AppiumBy;6import java.net.URL;7import org.openqa.selenium.remote.DesiredCapabilities;8import org.testng.annotations.Test;9public class iOSClassChainTest {10    public void iOSClassChain() throws Exception {11        DesiredCapabilities capabilities = new DesiredCapabilities();12        capabilities.setCapability(MobileCapabilityType.PLATFORM_NAME, "iOS");13        capabilities.setCapability(MobileCapabilityType.PLATFORM_VERSION, "11.2");14        capabilities.setCapability(MobileCapabilityType.DEVICE_NAME, "iPhone 6s");15        capabilities.setCapability(MobileCapabilityType.APP, "/path/to/your.app");

1import java.net.URL;2import java.util.List;3import org.openqa.selenium.By;4import org.openqa.selenium.WebElement;5import org.openqa.selenium.remote.DesiredCapabilities;6import io.appium.java_client.AppiumDriver;7import io.appium.java_client.MobileElement;8import io.appium.java_client.ios.IOSDriver;9import io.appium.java_client.remote.MobileCapabilityType;10public class ClassChain {11    private static AppiumDriver<MobileElement> driver;12    public static void main(String[] args) throws Exception {13        DesiredCapabilities caps = new DesiredCapabilities();14        caps.setCapability(MobileCapabilityType.DEVICE_NAME, "iPhone 8");15        caps.setCapability(MobileCapabilityType.PLATFORM_NAME, "iOS");16        caps.setCapability(MobileCapabilityType.PLATFORM_VERSION, "13.4.1");17        caps.setCapability(MobileCapabilityType.UDID, "00008020-000E2B2C0A74002E");18        caps.setCapability(MobileCapabilityType.AUTOMATION_NAME, "XCUITest");19        caps.setCapability(MobileCapabilityType.APP, "/Users/username/Library/Developer/Xcode/DerivedData/Calculator-fjxjxkzvzgqjwqfjxgjzjzgjzvzy/Build/Products/Debug-iphonesimulator/Calculator.app");20        caps.setCapability(MobileCapabilityType.NO_RESET, true);21        caps.setCapability(MobileCapabilityType.FULL_RESET, false);

1MobileElement element = (MobileElement) driver.findElement(MobileBy.iOSClassChain("**/XCUIElementTypeOther[`name == \"Add to Watchlist\"`][2]"));2element.click();3let element = await driver.findElement(MobileBy.iOSClassChain("**/XCUIElementTypeOther[`name == \"Add to Watchlist\"`][2]"));4await element.click();5element = driver.find_element(MobileBy.iOSClassChain("**/XCUIElementTypeOther[`name == \"Add to Watchlist\"`][2]"))6element.click()7element = driver.find_element(MobileBy.iOSClassChain("**/XCUIElementTypeOther[`name == \"Add to Watchlist\"`][2]"))8element.click()9MobileElement element = (MobileElement) driver.findElement(MobileBy.iOSClassChain("**/XCUIElementTypeOther[`name == \"Add to Watchlist\"`][2]"));10element.click();11element := driver.FindElement(MobileBy.iOSClassChain("**/XCUIElementTypeOther[`name == \"Add to Watchlist\"`][2]"))12element.Click()13$element = $driver->findElement(MobileBy::iOSClassChain("**/XCUIElementTypeOther[`name == \"Add to Watchlist\"`][2]"))14$element->click()