appium-dom-utils

Appium utils implemented with DOM

Usage no npm install needed!

<script type="module">
  import appiumDomUtils from 'https://cdn.skypack.dev/appium-dom-utils';
</script>

README

Installation

NPM Version NPM DownloadsLicense

npm i -S appium-dom-utils

appium-dom-utils

A collection of util functions for writing Appium tests using DOM API.

const {
  parseDomFromString,
  getXPathSelector,
} = require('appium-dom-utils');
const wdio = require("webdriverio");

const client = await webdriverio.remote(opts);
const xmlSourceString = await client.getPageSource();
const dom = parseDomFromString(xmlSourceString);
const domElement = dom.querySelector("[text*='9']");
const xpath = getXPathSelector(domElement);
const appiumElement = await client.$(xpath);
await appiumElement.click();
await client.deleteSession();

API

parseDomFromString(xml: String)

Returns a DOM object. Throws when the xml string is not formatted well. Currently tested with the return value of driver.getPageSource() for both Android (UiAutomator2) and iOS (UIAutomation) tests.

import { parseDomFromString } from 'appium-dom-utils';
parseDomFromString(xmlString);

getXPathSelector(el: Element)

Returns the xpath (string) for the element supplied. [Android UiAutomator2 tests].

import { getXPathSelector } from 'appium-dom-utils';
getXPathSelector(element);

getClassChainSelector(el: Element)

Returns the class chain (string) for the element supplied. [iOS UIAutomation tests].

import { getClassChainSelector } from 'appium-dom-utils';
getClassChainSelector(element);