webdriverio 7.17.0 → 7.18.0

package/build/multiremote.js

@@ -0,0 +1,160 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiRemoteDriver = void 0;
+const lodash_zip_1 = __importDefault(require("lodash.zip"));
+const lodash_clonedeep_1 = __importDefault(require("lodash.clonedeep"));
+const utils_1 = require("@wdio/utils");
+const middlewares_1 = require("./middlewares");
+const utils_2 = require("./utils");
+/**
+ * Multiremote class
+ */
+class MultiRemote {
+    constructor() {
+        this.instances = {};
+    }
+    /**
+     * add instance to multibrowser instance
+     */
+    async addInstance(browserName, client) {
+        this.instances[browserName] = await client;
+        return this.instances[browserName];
+    }
+    /**
+     * modifier for multibrowser instance
+     */
+    modifier(wrapperClient) {
+        const propertiesObject = {};
+        propertiesObject.commandList = { value: wrapperClient.commandList };
+        propertiesObject.options = { value: wrapperClient.options };
+        for (const commandName of wrapperClient.commandList) {
+            propertiesObject[commandName] = {
+                value: this.commandWrapper(commandName),
+                configurable: true
+            };
+        }
+        propertiesObject['__propertiesObject__'] = {
+            value: propertiesObject
+        };
+        this.baseInstance = new MultiRemoteDriver(this.instances, propertiesObject);
+        const client = Object.create(this.baseInstance, propertiesObject);
+        /**
+         * attach instances to wrapper client
+         */
+        for (const [identifier, instance] of Object.entries(this.instances)) {
+            client[identifier] = instance;
+        }
+        return client;
+    }
+    /**
+     * helper method to generate element objects from results, so that we can call, e.g.
+     *
+     * ```
+     * const elem = $('#elem')
+     * elem.getHTML()
+     * ```
+     *
+     * or in case multiremote is used
+     *
+     * ```
+     * const elems = $$('div')
+     * elems[0].getHTML()
+     * ```
+     */
+    static elementWrapper(instances, result, propertiesObject, scope) {
+        const prototype = { ...propertiesObject, ...(0, lodash_clonedeep_1.default)((0, utils_2.getPrototype)('element')), scope: { value: 'element' } };
+        const element = (0, utils_1.webdriverMonad)({}, (client) => {
+            /**
+             * attach instances to wrapper client
+             */
+            for (const [i, identifier] of Object.entries(Object.keys(instances))) {
+                client[identifier] = result[i];
+            }
+            client.instances = Object.keys(instances);
+            client.isMultiremote = true;
+            client.selector = result[0] ? result[0].selector : null;
+            delete client.sessionId;
+            return client;
+        }, prototype);
+        // @ts-ignore
+        return element(this.sessionId, (0, middlewares_1.multiremoteHandler)(scope.commandWrapper.bind(scope)));
+    }
+    /**
+     * handle commands for multiremote instances
+     */
+    commandWrapper(commandName) {
+        const instances = this.instances;
+        const self = this;
+        return (0, utils_1.wrapCommand)(commandName, async function (...args) {
+            const mElem = this;
+            const scope = this.selector
+                ? Object.entries(mElem.instances.reduce((ins, instanceName) => ({ ...ins, [instanceName]: mElem[instanceName] }), {}))
+                : Object.entries(instances);
+            const result = await Promise.all(scope.map(
+            // @ts-expect-error
+            ([, instance]) => instance[commandName](...args)));
+            /**
+             * return element object to call commands directly
+             */
+            if (commandName === '$') {
+                const elem = MultiRemote.elementWrapper(instances, result, this.__propertiesObject__, self);
+                return elem;
+            }
+            else if (commandName === '$$') {
+                const zippedResult = (0, lodash_zip_1.default)(...result);
+                return zippedResult.map((singleResult) => MultiRemote.elementWrapper(instances, singleResult, this.__propertiesObject__, self));
+            }
+            return result;
+        });
+    }
+}
+exports.default = MultiRemote;
+/**
+ * event listener class that propagates events to sub drivers
+ */
+/* istanbul ignore next */
+class MultiRemoteDriver {
+    constructor(instances, propertiesObject) {
+        this.isMultiremote = true;
+        this.instances = Object.keys(instances);
+        this.__propertiesObject__ = propertiesObject;
+    }
+    on(eventName, emitter) {
+        this.instances.forEach((instanceName) => this[instanceName].on(eventName, emitter));
+        return undefined;
+    }
+    once(eventName, emitter) {
+        this.instances.forEach((instanceName) => this[instanceName].once(eventName, emitter));
+        return undefined;
+    }
+    emit(eventName, emitter) {
+        return this.instances.map((instanceName) => this[instanceName].emit(eventName, emitter)).some(Boolean);
+    }
+    eventNames() {
+        return this.instances.map((instanceName) => this[instanceName].eventNames()); // special behavior of event methods for multiremote
+    }
+    getMaxListeners() {
+        return this.instances.map((instanceName) => this[instanceName].getMaxListeners()); // special behavior of event methods for multiremote
+    }
+    listenerCount(eventName) {
+        return this.instances.map((instanceName) => this[instanceName].listenerCount(eventName)); // special behavior of event methods for multiremote
+    }
+    listeners(eventName) {
+        return this.instances.map((instanceName) => this[instanceName].listeners(eventName)).reduce((prev, cur) => {
+            prev.concat(cur);
+            return prev;
+        }, []);
+    }
+    removeListener(eventName, emitter) {
+        this.instances.forEach((instanceName) => this[instanceName].removeListener(eventName, emitter));
+        return undefined;
+    }
+    removeAllListeners(eventName) {
+        this.instances.forEach((instanceName) => this[instanceName].removeAllListeners(eventName));
+        return undefined;
+    }
+}
+exports.MultiRemoteDriver = MultiRemoteDriver;

package/build/protocol-stub.d.ts

@@ -0,0 +1,16 @@
+import type { Options } from '@wdio/types';
+import type { AttachOptions } from 'webdriver';
+/**
+ * create `browser` object with capabilities and environment flags before session is started
+ * so that Mocha/Jasmine users can filter their specs based on flags or use capabilities in test titles
+ */
+export default class ProtocolStub {
+    static newSession(options: Options.WebDriver): Promise<Record<string, any>>;
+    /**
+     * added just in case user wants to somehow reload webdriver or devtools session
+     * before it was started.
+     */
+    static reloadSession(): void;
+    static attachToSession(options: AttachOptions, modifier?: (...args: any[]) => any): Record<string, any>;
+}
+//# sourceMappingURL=protocol-stub.d.ts.map

package/build/protocol-stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-stub.d.ts","sourceRoot":"","sources":["../src/protocol-stub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,OAAO,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAO9C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,YAAY;WAChB,UAAU,CAAE,OAAO,EAAE,OAAO,CAAC,SAAS;IAanD;;;OAGG;IACH,MAAM,CAAC,aAAa;IAIpB,MAAM,CAAC,eAAe,CAClB,OAAO,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG;CAazC"}

package/build/protocol-stub.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("@wdio/utils");
+/**
+ * these commands can be used outside test scope and may be used accidentally by user before browser session is started
+ */
+const WARN_ON_COMMANDS = ['addCommand', 'overwriteCommand'];
+/**
+ * create `browser` object with capabilities and environment flags before session is started
+ * so that Mocha/Jasmine users can filter their specs based on flags or use capabilities in test titles
+ */
+class ProtocolStub {
+    static async newSession(options) {
+        const capabilities = emulateSessionCapabilities((options.capabilities || {}));
+        const browser = addCommands({
+            capabilities,
+            ...(0, utils_1.capabilitiesEnvironmentDetector)(capabilities, options._automationProtocol || 'webdriver')
+        });
+        return browser;
+    }
+    /**
+     * added just in case user wants to somehow reload webdriver or devtools session
+     * before it was started.
+     */
+    static reloadSession() {
+        throw new Error('Protocol Stub: Make sure to start webdriver or devtools session before reloading it.');
+    }
+    static attachToSession(options, modifier) {
+        if (options || !modifier) {
+            return ProtocolStub.newSession(options);
+        }
+        /**
+         * MultiRemote
+         */
+        return addCommands(modifier({
+            commandList: []
+        }));
+    }
+}
+exports.default = ProtocolStub;
+/**
+ * provide better visibility to users that want to add / overwrite commands
+ * before session is started
+ * @param {object} browser
+ */
+function addCommands(browser) {
+    WARN_ON_COMMANDS.forEach((commandName) => {
+        browser[commandName] = commandNotAvailable(commandName);
+    });
+    return browser;
+}
+/**
+ * transform capabilities provided by user to look like
+ * capabilities returned by WebDriver
+ * @param   {object} caps user defined capabilities
+ * @return  {object}
+ */
+function emulateSessionCapabilities(caps) {
+    const capabilities = {};
+    // remove appium vendor prefix from capabilities
+    Object.entries(caps).forEach(([key, value]) => {
+        const newKey = key.replace('appium:', '');
+        capabilities[newKey] = value;
+    });
+    // isChrome
+    if (caps.browserName && caps.browserName.toLowerCase() === 'chrome') {
+        capabilities.chrome = true;
+    }
+    return capabilities;
+}
+/**
+ * warn user to avoid usage of command before browser session is started.
+ * @param {string} commandName
+ */
+function commandNotAvailable(commandName) {
+    return () => { throw new Error(`Unable to use '${commandName}' before browser session is started.`); };
+}

package/build/scripts/getHTML.d.ts

@@ -0,0 +1,9 @@
+/**
+ * get HTML of selector element
+ *
+ * @param  {String}  element             element to get HTML from
+ * @param  {Boolean} includeSelectorTag  if true, selector tag gets included (uses outerHTML)
+ * @return {String}                      html source
+ */
+export default function getHTML(element: HTMLElement, includeSelectorTag: boolean): string;
+//# sourceMappingURL=getHTML.d.ts.map

package/build/scripts/getHTML.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getHTML.d.ts","sourceRoot":"","sources":["../../src/scripts/getHTML.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,UAEjF"}

package/build/scripts/getHTML.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * get HTML of selector element
+ *
+ * @param  {String}  element             element to get HTML from
+ * @param  {Boolean} includeSelectorTag  if true, selector tag gets included (uses outerHTML)
+ * @return {String}                      html source
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+function getHTML(element, includeSelectorTag) {
+    return element[includeSelectorTag ? 'outerHTML' : 'innerHTML'];
+}
+exports.default = getHTML;

package/build/scripts/getProperty.d.ts

@@ -0,0 +1,43 @@
+/**
+ * get property from element
+ * @param  {String} element    element with requested property
+ * @param  {String} property   requested property
+ * @return {String}            the value of the property
+ */
+export default function getProperty(element: HTMLElement, property: keyof HTMLElement): string | number | boolean | HTMLElement | Element | ChildNode | ParentNode | (() => DOMRect) | Document | ((event: Event) => boolean) | ((this: GlobalEventHandlers, ev: UIEvent) => any) | ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | ((this: GlobalEventHandlers, ev: MouseEvent) => any) | ((this: GlobalEventHandlers, ev: FocusEvent) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: MouseEvent) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: MouseEvent) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: MouseEvent) => any) | ((this: GlobalEventHandlers, ev: DragEvent) => any) | ((this: GlobalEventHandlers, ev: DragEvent) => any) | ((this: GlobalEventHandlers, ev: DragEvent) => any) | ((this: GlobalEventHandlers, ev: DragEvent) => any) | ((this: GlobalEventHandlers, ev: DragEvent) => any) | ((this: GlobalEventHandlers, ev: DragEvent) => any) | ((this: GlobalEventHandlers, ev: DragEvent) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | OnErrorEventHandler | ((this: GlobalEventHandlers, ev: FocusEvent) => any) | ((this: GlobalEventHandlers, ev: FormDataEvent) => any) | ((this: GlobalEventHandlers, ev: PointerEvent) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: PointerEvent) => any) | ((this: GlobalEventHandlers, ev: MouseEvent) => any) | ((this: GlobalEventHandlers, ev: MouseEvent) => any) | ((this: GlobalEventHandlers, ev: MouseEvent) => any) | ((this: GlobalEventHandlers, ev: MouseEvent) => any) | ((this: GlobalEventHandlers, ev: MouseEvent) => any) | ((this: GlobalEventHandlers, ev: MouseEvent) => any) | ((this: GlobalEventHandlers, ev: MouseEvent) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: PointerEvent) => any) | ((this: GlobalEventHandlers, ev: PointerEvent) => any) | ((this: GlobalEventHandlers, ev: PointerEvent) => any) | ((this: GlobalEventHandlers, ev: PointerEvent) => any) | ((this: GlobalEventHandlers, ev: PointerEvent) => any) | ((this: GlobalEventHandlers, ev: PointerEvent) => any) | ((this: GlobalEventHandlers, ev: PointerEvent) => any) | ((this: GlobalEventHandlers, ev: PointerEvent) => any) | ((this: GlobalEventHandlers, ev: ProgressEvent<EventTarget>) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: UIEvent) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: SecurityPolicyViolationEvent) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: SubmitEvent) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: TouchEvent) => any) | ((this: GlobalEventHandlers, ev: TouchEvent) => any) | ((this: GlobalEventHandlers, ev: TouchEvent) => any) | ((this: GlobalEventHandlers, ev: TouchEvent) => any) | ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: Event) => any) | ((this: GlobalEventHandlers, ev: WheelEvent) => any) | (() => ElementInternals) | (() => void) | {
+    <K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions | undefined): void;
+    (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions | undefined): void;
+} | {
+    <K_1 extends keyof HTMLElementEventMap>(type: K_1, listener: (this: HTMLElement, ev: HTMLElementEventMap[K_1]) => any, options?: boolean | EventListenerOptions | undefined): void;
+    (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions | undefined): void;
+} | NamedNodeMap | DOMTokenList | ((this: Element, ev: Event) => any) | ((this: Element, ev: Event) => any) | ShadowRoot | ((init: ShadowRootInit) => ShadowRoot) | {
+    <K_2 extends keyof HTMLElementTagNameMap>(selector: K_2): HTMLElementTagNameMap[K_2] | null;
+    <K_3 extends keyof SVGElementTagNameMap>(selector: K_3): SVGElementTagNameMap[K_3] | null;
+    <E extends Element = Element>(selectors: string): E | null;
+} | ((qualifiedName: string) => string | null) | ((namespace: string | null, localName: string) => string | null) | (() => string[]) | ((qualifiedName: string) => Attr | null) | ((namespace: string | null, localName: string) => Attr | null) | (() => DOMRectList) | ((classNames: string) => HTMLCollectionOf<Element>) | {
+    <K_4 extends keyof HTMLElementTagNameMap>(qualifiedName: K_4): HTMLCollectionOf<HTMLElementTagNameMap[K_4]>;
+    <K_5 extends keyof SVGElementTagNameMap>(qualifiedName: K_5): HTMLCollectionOf<SVGElementTagNameMap[K_5]>;
+    (qualifiedName: string): HTMLCollectionOf<Element>;
+} | {
+    (namespaceURI: "http://www.w3.org/1999/xhtml", localName: string): HTMLCollectionOf<HTMLElement>;
+    (namespaceURI: "http://www.w3.org/2000/svg", localName: string): HTMLCollectionOf<SVGElement>;
+    (namespace: string | null, localName: string): HTMLCollectionOf<Element>;
+} | ((qualifiedName: string) => boolean) | ((namespace: string | null, localName: string) => boolean) | (() => boolean) | ((pointerId: number) => boolean) | ((where: InsertPosition, element: Element) => Element | null) | ((position: InsertPosition, text: string) => void) | ((where: InsertPosition, data: string) => void) | ((selectors: string) => boolean) | ((pointerId: number) => void) | ((qualifiedName: string) => void) | ((namespace: string | null, localName: string) => void) | ((attr: Attr) => Attr) | ((options?: FullscreenOptions | undefined) => Promise<void>) | (() => void) | {
+    (options?: ScrollToOptions | undefined): void;
+    (x: number, y: number): void;
+} | {
+    (options?: ScrollToOptions | undefined): void;
+    (x: number, y: number): void;
+} | ((arg?: boolean | ScrollIntoViewOptions | undefined) => void) | {
+    (options?: ScrollToOptions | undefined): void;
+    (x: number, y: number): void;
+} | ((qualifiedName: string, value: string) => void) | ((namespace: string | null, qualifiedName: string, value: string) => void) | ((attr: Attr) => Attr | null) | ((attr: Attr) => Attr | null) | ((pointerId: number) => void) | ((qualifiedName: string, force?: boolean | undefined) => boolean) | ((selectors: string) => boolean) | NodeListOf<ChildNode> | (<T extends Node>(node: T) => T) | ((deep?: boolean | undefined) => Node) | ((other: Node) => number) | ((other: Node | null) => boolean) | ((options?: GetRootNodeOptions | undefined) => Node) | (() => boolean) | (<T_1 extends Node>(node: T_1, child: Node | null) => T_1) | ((namespace: string | null) => boolean) | ((otherNode: Node | null) => boolean) | ((otherNode: Node | null) => boolean) | ((prefix: string | null) => string | null) | ((namespace: string | null) => string | null) | (() => void) | (<T_2 extends Node>(child: T_2) => T_2) | (<T_3 extends Node>(node: Node, child: T_3) => T_3) | ((keyframes: Keyframe[] | PropertyIndexedKeyframes | null, options?: number | KeyframeAnimationOptions | undefined) => Animation) | ((options?: GetAnimationsOptions | undefined) => Animation[]) | ((...nodes: (string | Node)[]) => void) | ((...nodes: (string | Node)[]) => void) | (() => void) | ((...nodes: (string | Node)[]) => void) | HTMLCollection | ((...nodes: (string | Node)[]) => void) | ((...nodes: (string | Node)[]) => void) | {
+    <K_6 extends keyof HTMLElementTagNameMap>(selectors: K_6): HTMLElementTagNameMap[K_6] | null;
+    <K_7 extends keyof SVGElementTagNameMap>(selectors: K_7): SVGElementTagNameMap[K_7] | null;
+    <E_1 extends Element = Element>(selectors: string): E_1 | null;
+} | {
+    <K_8 extends keyof HTMLElementTagNameMap>(selectors: K_8): NodeListOf<HTMLElementTagNameMap[K_8]>;
+    <K_9 extends keyof SVGElementTagNameMap>(selectors: K_9): NodeListOf<SVGElementTagNameMap[K_9]>;
+    <E_2 extends Element = Element>(selectors: string): NodeListOf<E_2>;
+} | ((...nodes: (string | Node)[]) => void) | HTMLSlotElement | ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | CSSStyleDeclaration | DOMStringMap | (() => void) | ((options?: FocusOptions | undefined) => void) | undefined;
+//# sourceMappingURL=getProperty.d.ts.map

package/build/scripts/getProperty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getProperty.d.ts","sourceRoot":"","sources":["../../src/scripts/getProperty.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oYAErF"}

package/build/scripts/getProperty.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * get property from element
+ * @param  {String} element    element with requested property
+ * @param  {String} property   requested property
+ * @return {String}            the value of the property
+ */
+function getProperty(element, property) {
+    return element[property];
+}
+exports.default = getProperty;

package/build/scripts/isElementClickable.d.ts

@@ -0,0 +1,7 @@
+/**
+ * check if element is within the viewport or is overlapped by another element or disabled
+ * @param  {HTMLElement} elem  element to check
+ * @return {Boolean}           false if element is not overlapped
+ */
+export default function isElementClickable(elem: HTMLElement): boolean;
+//# sourceMappingURL=isElementClickable.d.ts.map

package/build/scripts/isElementClickable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isElementClickable.d.ts","sourceRoot":"","sources":["../../src/scripts/isElementClickable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAE,IAAI,EAAE,WAAW,WA4I5D"}

package/build/scripts/isElementClickable.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * check if element is within the viewport or is overlapped by another element or disabled
+ * @param  {HTMLElement} elem  element to check
+ * @return {Boolean}           false if element is not overlapped
+ */
+function isElementClickable(elem) {
+    if (!elem.getBoundingClientRect || !elem.scrollIntoView || !elem.contains || !elem.getClientRects || !document.elementFromPoint) {
+        return false;
+    }
+    // Edge before switching to Chromium
+    const isOldEdge = !!window.StyleMedia;
+    // returns true for Chrome and Firefox and false for Safari, Edge and IE
+    const scrollIntoViewFullSupport = !(window.safari || isOldEdge);
+    // get overlapping element
+    function getOverlappingElement(elem, context) {
+        context = context || document;
+        const elemDimension = elem.getBoundingClientRect();
+        const x = elemDimension.left + (elem.clientWidth / 2);
+        const y = elemDimension.top + (elem.clientHeight / 2);
+        return context.elementFromPoint(x, y);
+    }
+    // get overlapping element rects (currently only the first)
+    // applicable if element's text is multiline.
+    function getOverlappingRects(elem, context) {
+        context = context || document;
+        const elems = [];
+        const rects = elem.getClientRects();
+        // webdriver clicks on center of the first element's rect (line of text), it might change in future
+        const rect = rects[0];
+        const x = rect.left + (rect.width / 2);
+        const y = rect.top + (rect.height / 2);
+        elems.push(context.elementFromPoint(x, y));
+        return elems;
+    }
+    // get overlapping elements
+    function getOverlappingElements(elem, context) {
+        return [getOverlappingElement(elem, context)].concat(getOverlappingRects(elem, context));
+    }
+    // is a node a descendant of a given node
+    function nodeContains(elem, otherNode) {
+        // Edge doesn't support neither Shadow Dom nor contains if ShadowRoot polyfill is used
+        if (isOldEdge) {
+            let tmpElement = otherNode;
+            while (tmpElement) {
+                if (tmpElement === elem) {
+                    return true;
+                }
+                tmpElement = tmpElement.parentNode;
+                // DocumentFragment / ShadowRoot polyfill like ShadyRoot
+                if (tmpElement && tmpElement.nodeType === 11 && tmpElement.host) {
+                    tmpElement = tmpElement.host;
+                }
+            }
+            return false;
+        }
+        return elem.contains(otherNode);
+    }
+    // is one of overlapping elements the `elem` or one of its child
+    function isOverlappingElementMatch(elementsFromPoint, elem) {
+        if (elementsFromPoint.some(function (elementFromPoint) {
+            return elementFromPoint === elem || nodeContains(elem, elementFromPoint);
+        })) {
+            return true;
+        }
+        // shadow root
+        // filter unique elements with shadowRoot
+        // @ts-ignore
+        let elemsWithShadowRoot = [].concat(elementsFromPoint);
+        elemsWithShadowRoot = elemsWithShadowRoot.filter(function (x) {
+            return x && x.shadowRoot && x.shadowRoot.elementFromPoint;
+        });
+        // getOverlappingElements of every element with shadowRoot
+        let shadowElementsFromPoint = [];
+        for (let i = 0; i < elemsWithShadowRoot.length; ++i) {
+            let shadowElement = elemsWithShadowRoot[i];
+            shadowElementsFromPoint = shadowElementsFromPoint.concat(getOverlappingElements(elem, shadowElement.shadowRoot));
+        }
+        // remove duplicates and parents
+        // @ts-ignore
+        shadowElementsFromPoint = [].concat(shadowElementsFromPoint);
+        shadowElementsFromPoint = shadowElementsFromPoint.filter(function (x) {
+            return !elementsFromPoint.includes(x);
+        });
+        if (shadowElementsFromPoint.length === 0) {
+            return false;
+        }
+        return isOverlappingElementMatch(shadowElementsFromPoint, elem);
+    }
+    // copied from `isElementInViewport.js`
+    function isElementInViewport(elem) {
+        if (!elem.getBoundingClientRect) {
+            return false;
+        }
+        const rect = elem.getBoundingClientRect();
+        const windowHeight = (window.innerHeight || document.documentElement.clientHeight);
+        const windowWidth = (window.innerWidth || document.documentElement.clientWidth);
+        const vertInView = (rect.top <= windowHeight) && ((rect.top + rect.height) > 0);
+        const horInView = (rect.left <= windowWidth) && ((rect.left + rect.width) > 0);
+        return (vertInView && horInView);
+    }
+    function isClickable(elem) {
+        return (isElementInViewport(elem) && elem.disabled !== true &&
+            isOverlappingElementMatch(getOverlappingElements(elem), elem));
+    }
+    // scroll to the element if it's not clickable
+    if (!isClickable(elem)) {
+        // works well in dialogs, but the element may be still overlapped by some sticky header/footer
+        elem.scrollIntoView(scrollIntoViewFullSupport ? { block: 'nearest', inline: 'nearest' } : false);
+        // if element is still not clickable take another scroll attempt
+        if (!isClickable(elem)) {
+            // scroll to element, try put it in the screen center.
+            // Should definitely work even if element was covered with sticky header/footer
+            elem.scrollIntoView(scrollIntoViewFullSupport ? { block: 'center', inline: 'center' } : true);
+            return isClickable(elem);
+        }
+    }
+    return true;
+}
+exports.default = isElementClickable;

package/build/scripts/isElementDisplayed.d.ts

@@ -0,0 +1,7 @@
+/**
+ * check if element is visible
+ * @param  {HTMLElement} elem  element to check
+ * @return {Boolean}           true if element is within viewport
+ */
+export default function isElementDisplayed(element: Element): boolean;
+//# sourceMappingURL=isElementDisplayed.d.ts.map

package/build/scripts/isElementDisplayed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isElementDisplayed.d.ts","sourceRoot":"","sources":["../../src/scripts/isElementDisplayed.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAsOrE"}