@applitools/driver 1.4.17-beta.2 → 1.5.2

package/dist/driver.js

@@ -1,519 +1,519 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Driver = void 0;
-const utils = __importStar(require("@applitools/utils"));
-const specUtils = __importStar(require("./spec-utils"));
-const context_1 = require("./context");
-const helper_ios_1 = require("./helper-ios");
-const helper_android_1 = require("./helper-android");
-const user_agent_1 = require("./user-agent");
-const capabilities_1 = require("./capabilities");
-const snippets = require('@applitools/snippets');
-// eslint-disable-next-line
-class Driver {
-    constructor(options) {
-        var _a, _b, _c, _d, _e, _f;
-        if (options.driver instanceof Driver)
-            return options.driver;
-        this._spec = options.spec;
-        if (options.logger)
-            this._logger = options.logger;
-        if (this._spec.isDriver(options.driver)) {
-            this._target = (_c = (_b = (_a = this._spec).transformDriver) === null || _b === void 0 ? void 0 : _b.call(_a, options.driver)) !== null && _c !== void 0 ? _c : options.driver;
-        }
-        else {
-            throw new TypeError('Driver constructor called with argument of unknown type!');
-        }
-        this._mainContext = new context_1.Context({
-            spec: this._spec,
-            context: (_f = (_e = (_d = this._spec).extractContext) === null || _e === void 0 ? void 0 : _e.call(_d, this._target)) !== null && _f !== void 0 ? _f : this._target,
-            driver: this,
-            logger: this._logger,
-        });
-        this._currentContext = this._mainContext;
-    }
-    get target() {
-        return this._target;
-    }
-    get currentContext() {
-        return this._currentContext;
-    }
-    get mainContext() {
-        return this._mainContext;
-    }
-    get helper() {
-        return this._helper;
-    }
-    get features() {
-        var _a;
-        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.features;
-    }
-    get deviceName() {
-        var _a;
-        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.deviceName;
-    }
-    get platformName() {
-        var _a;
-        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.platformName;
-    }
-    get platformVersion() {
-        var _a;
-        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.platformVersion;
-    }
-    get browserName() {
-        var _a;
-        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.browserName;
-    }
-    get browserVersion() {
-        var _a;
-        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.browserVersion;
-    }
-    get userAgent() {
-        var _a;
-        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.userAgent;
-    }
-    get orientation() {
-        return this._driverInfo.orientation;
-    }
-    get pixelRatio() {
-        var _a;
-        return (_a = this._driverInfo.pixelRatio) !== null && _a !== void 0 ? _a : 1;
-    }
-    get viewportScale() {
-        var _a;
-        return (_a = this._driverInfo.viewportScale) !== null && _a !== void 0 ? _a : 1;
-    }
-    get statusBarHeight() {
-        var _a;
-        return (_a = this._driverInfo.statusBarHeight) !== null && _a !== void 0 ? _a : (this.isNative ? 0 : undefined);
-    }
-    get navigationBarHeight() {
-        var _a;
-        return (_a = this._driverInfo.navigationBarHeight) !== null && _a !== void 0 ? _a : (this.isNative ? 0 : undefined);
-    }
-    get isNative() {
-        var _a, _b;
-        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isNative) !== null && _b !== void 0 ? _b : false;
-    }
-    get isWeb() {
-        return !this.isNative;
-    }
-    get isMobile() {
-        var _a, _b;
-        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isMobile) !== null && _b !== void 0 ? _b : false;
-    }
-    get isIOS() {
-        return this.platformName === 'iOS';
-    }
-    get isAndroid() {
-        return this.platformName === 'Android';
-    }
-    get isIE() {
-        return /(internet explorer|ie)/i.test(this.browserName);
-    }
-    get isEdgeLegacy() {
-        return /edge/i.test(this.browserName) && Number(this.browserVersion) <= 44;
-    }
-    updateCurrentContext(context) {
-        this._currentContext = context;
-    }
-    async init() {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
-        var _w, _x, _y, _z, _0, _1, _2, _3;
-        const capabilities = await ((_b = (_a = this._spec).getCapabilities) === null || _b === void 0 ? void 0 : _b.call(_a, this.target));
-        this._logger.log('Driver capabilities', capabilities);
-        const capabilitiesInfo = capabilities ? capabilities_1.parseCapabilities(capabilities) : undefined;
-        const driverInfo = await ((_d = (_c = this._spec).getDriverInfo) === null || _d === void 0 ? void 0 : _d.call(_c, this.target));
-        this._driverInfo = Object.assign(Object.assign({}, capabilitiesInfo), driverInfo);
-        if (this.isWeb) {
-            (_e = (_w = this._driverInfo).pixelRatio) !== null && _e !== void 0 ? _e : (_w.pixelRatio = await this.execute(snippets.getPixelRatio));
-            (_f = (_x = this._driverInfo).viewportScale) !== null && _f !== void 0 ? _f : (_x.viewportScale = await this.execute(snippets.getViewportScale));
-            (_g = (_y = this._driverInfo).userAgent) !== null && _g !== void 0 ? _g : (_y.userAgent = await this.execute(snippets.getUserAgent));
-            if (this._driverInfo.userAgent) {
-                const userAgentInfo = user_agent_1.parseUserAgent(this._driverInfo.userAgent);
-                this._driverInfo.browserName = (_h = userAgentInfo.browserName) !== null && _h !== void 0 ? _h : this._driverInfo.browserName;
-                this._driverInfo.browserVersion = (_j = userAgentInfo.browserVersion) !== null && _j !== void 0 ? _j : this._driverInfo.browserVersion;
-                if (this._driverInfo.isMobile) {
-                    (_k = (_z = this._driverInfo).platformName) !== null && _k !== void 0 ? _k : (_z.platformName = userAgentInfo.platformName);
-                    (_l = (_0 = this._driverInfo).platformVersion) !== null && _l !== void 0 ? _l : (_0.platformVersion = userAgentInfo.platformVersion);
-                }
-                else {
-                    this._driverInfo.platformName = (_m = userAgentInfo.platformName) !== null && _m !== void 0 ? _m : this._driverInfo.platformName;
-                    this._driverInfo.platformVersion = (_o = userAgentInfo.platformVersion) !== null && _o !== void 0 ? _o : this._driverInfo.platformVersion;
-                }
-            }
-            (_p = (_1 = this._driverInfo).features) !== null && _p !== void 0 ? _p : (_1.features = {});
-            (_q = (_2 = this._driverInfo.features).allCookies) !== null && _q !== void 0 ? _q : (_2.allCookies = /chrome/i.test(this._driverInfo.browserName) && !this._driverInfo.isMobile);
-        }
-        else {
-            const barsHeight = await ((_s = (_r = this._spec).getBarsHeight) === null || _s === void 0 ? void 0 : _s.call(_r, this.target).catch(() => undefined));
-            const displaySize = await this.getDisplaySize();
-            // calculate status and navigation bars sizes
-            if (barsHeight) {
-                // when status bar is overlapping content on android it returns status bar height equal to viewport height
-                if (this.isAndroid && barsHeight.statusBarHeight / this.pixelRatio < displaySize.height) {
-                    this._driverInfo.statusBarHeight = Math.max((_t = this._driverInfo.statusBarHeight) !== null && _t !== void 0 ? _t : 0, barsHeight.statusBarHeight);
-                }
-                this._driverInfo.navigationBarHeight = Math.max((_u = this._driverInfo.navigationBarHeight) !== null && _u !== void 0 ? _u : 0, barsHeight.navigationBarHeight);
-            }
-            if (this.isAndroid) {
-                this._driverInfo.statusBarHeight /= this.pixelRatio;
-                this._driverInfo.navigationBarHeight /= this.pixelRatio;
-            }
-            // calculate viewport size
-            if (!this._driverInfo.viewportSize) {
-                this._driverInfo.viewportSize = {
-                    width: displaySize.width,
-                    height: displaySize.height - this._driverInfo.statusBarHeight,
-                };
-            }
-            // calculate safe area
-            if (this.isIOS && !this._driverInfo.safeArea) {
-                this._driverInfo.safeArea = Object.assign({ x: 0, y: 0 }, displaySize);
-                const topElement = await this.element({ type: '-ios class chain', selector: '**/XCUIElementTypeNavigationBar' });
-                if (topElement) {
-                    const topRegion = await this._spec.getElementRegion(this.target, topElement.target);
-                    const topOffset = topRegion.y + topRegion.height;
-                    this._driverInfo.safeArea.y = topOffset;
-                    this._driverInfo.safeArea.height -= topOffset;
-                }
-                const bottomElement = await this.element({ type: '-ios class chain', selector: '**/XCUIElementTypeTabBar' });
-                if (bottomElement) {
-                    const bottomRegion = await this._spec.getElementRegion(this.target, bottomElement.target);
-                    const bottomOffset = bottomRegion.height;
-                    this._driverInfo.safeArea.height -= bottomOffset;
-                }
-            }
-            // init helper lib
-            this._helper = this.isIOS
-                ? await helper_ios_1.HelperIOS.make({ spec: this._spec, driver: this, logger: this._logger })
-                : await helper_android_1.HelperAndroid.make({ spec: this._spec, driver: this, logger: this._logger });
-        }
-        if (this.isMobile) {
-            (_v = (_3 = this._driverInfo).orientation) !== null && _v !== void 0 ? _v : (_3.orientation = await this.getOrientation().catch(() => undefined));
-        }
-        this._logger.log('Combined driver info', this._driverInfo);
-        return this;
-    }
-    async refreshContexts() {
-        if (this.isNative)
-            return this.currentContext;
-        const spec = this._spec;
-        let currentContext = this.currentContext.target;
-        let contextInfo = await getContextInfo(currentContext);
-        const path = [];
-        if (spec.parentContext) {
-            while (!contextInfo.isRoot) {
-                currentContext = await spec.parentContext(currentContext);
-                const contextReference = await findContextReference(currentContext, contextInfo);
-                if (!contextReference)
-                    throw new Error('Unable to find out the chain of frames');
-                path.unshift(contextReference);
-                contextInfo = await getContextInfo(currentContext);
-            }
-        }
-        else {
-            currentContext = await spec.mainContext(currentContext);
-            path.push(...(await findContextPath(currentContext, contextInfo)));
-        }
-        this._currentContext = this._mainContext;
-        return this.switchToChildContext(...path);
-        function transformSelector(selector) {
-            return specUtils.transformSelector(spec, selector, { isWeb: true });
-        }
-        async function getContextInfo(context) {
-            const [documentElement, selector, isRoot, isCORS] = await spec.executeScript(context, snippets.getContextInfo);
-            return { documentElement, selector, isRoot, isCORS };
-        }
-        async function getChildContextsInfo(context) {
-            const framesInfo = await spec.executeScript(context, snippets.getChildFramesInfo);
-            return framesInfo.map(([contextElement, isCORS]) => ({ contextElement, isCORS }));
-        }
-        async function isEqualElements(context, element1, element2) {
-            return spec.executeScript(context, snippets.isEqualElements, [element1, element2]).catch(() => false);
-        }
-        async function findContextReference(context, contextInfo) {
-            if (contextInfo.selector) {
-                const contextElement = await spec.findElement(context, transformSelector({ type: 'xpath', selector: contextInfo.selector }));
-                if (contextElement)
-                    return contextElement;
-            }
-            for (const childContextInfo of await getChildContextsInfo(context)) {
-                if (childContextInfo.isCORS !== contextInfo.isCORS)
-                    continue;
-                const childContext = await spec.childContext(context, childContextInfo.contextElement);
-                const contentDocument = await spec.findElement(childContext, transformSelector('html'));
-                const isWantedContext = await isEqualElements(childContext, contentDocument, contextInfo.documentElement);
-                await spec.parentContext(childContext);
-                if (isWantedContext)
-                    return childContextInfo.contextElement;
-            }
-        }
-        async function findContextPath(context, contextInfo, contextPath = []) {
-            const contentDocument = await spec.findElement(context, transformSelector('html'));
-            if (await isEqualElements(context, contentDocument, contextInfo.documentElement)) {
-                return contextPath;
-            }
-            for (const childContextInfo of await getChildContextsInfo(context)) {
-                const childContext = await spec.childContext(context, childContextInfo.contextElement);
-                const possibleContextPath = [...contextPath, childContextInfo.contextElement];
-                const wantedContextPath = await findContextPath(childContext, contextInfo, possibleContextPath);
-                await spec.mainContext(context);
-                if (wantedContextPath)
-                    return wantedContextPath;
-                for (const contextElement of contextPath) {
-                    await spec.childContext(context, contextElement);
-                }
-            }
-        }
-    }
-    async switchTo(context) {
-        if (await this.currentContext.equals(context)) {
-            this._currentContext = context;
-            return;
-        }
-        const currentPath = this.currentContext.path;
-        const requiredPath = context.path;
-        let diffIndex = -1;
-        for (const [index, context] of requiredPath.entries()) {
-            if (currentPath[index] && !(await currentPath[index].equals(context))) {
-                diffIndex = index;
-                break;
-            }
-        }
-        if (diffIndex === 0) {
-            throw new Error('Cannot switch to the context, because it has different main context');
-        }
-        else if (diffIndex === -1) {
-            if (currentPath.length === requiredPath.length) {
-                // required and current paths are the same
-                return this.currentContext;
-            }
-            else if (requiredPath.length > currentPath.length) {
-                // current path is a sub-path of required path
-                return this.switchToChildContext(...requiredPath.slice(currentPath.length));
-            }
-            else if (currentPath.length - requiredPath.length <= requiredPath.length) {
-                // required path is a sub-path of current path
-                return this.switchToParentContext(currentPath.length - requiredPath.length);
-            }
-            else {
-                // required path is a sub-path of current path
-                await this.switchToMainContext();
-                return this.switchToChildContext(...requiredPath);
-            }
-        }
-        else if (currentPath.length - diffIndex <= diffIndex) {
-            // required path is different from current or they are partially intersected
-            // chose an optimal way to traverse from current context to target context
-            await this.switchToParentContext(currentPath.length - diffIndex);
-            return this.switchToChildContext(...requiredPath.slice(diffIndex));
-        }
-        else {
-            await this.switchToMainContext();
-            return this.switchToChildContext(...requiredPath);
-        }
-    }
-    async switchToMainContext() {
-        if (this.isNative)
-            throw new Error('Contexts are supported only for web drivers');
-        this._logger.log('Switching to the main context');
-        await this._spec.mainContext(this.currentContext.target);
-        return (this._currentContext = this._mainContext);
-    }
-    async switchToParentContext(elevation = 1) {
-        if (this.isNative)
-            throw new Error('Contexts are supported only for web drivers');
-        this._logger.log('Switching to a parent context with elevation:', elevation);
-        if (this.currentContext.path.length <= elevation) {
-            return this.switchToMainContext();
-        }
-        try {
-            while (elevation > 0) {
-                await this._spec.parentContext(this.currentContext.target);
-                this._currentContext = this._currentContext.parent;
-                elevation -= 1;
-            }
-        }
-        catch (err) {
-            this._logger.warn('Unable to switch to a parent context due to error', err);
-            this._logger.log('Applying workaround to switch to the parent frame');
-            const path = this.currentContext.path.slice(1, -elevation);
-            await this.switchToMainContext();
-            await this.switchToChildContext(...path);
-            elevation = 0;
-        }
-        return this.currentContext;
-    }
-    async switchToChildContext(...references) {
-        if (this.isNative)
-            throw new Error('Contexts are supported only for web drivers');
-        this._logger.log('Switching to a child context with depth:', references.length);
-        for (const reference of references) {
-            if (reference === this.mainContext)
-                continue;
-            const context = await this.currentContext.context(reference);
-            await context.focus();
-        }
-        return this.currentContext;
-    }
-    async normalizeRegion(region) {
-        if (this.isWeb || !utils.types.has(this._driverInfo, ['viewportSize', 'statusBarHeight']))
-            return region;
-        const scaledRegion = this.isAndroid ? utils.geometry.scale(region, 1 / this.pixelRatio) : region;
-        const safeRegion = this.isIOS ? utils.geometry.intersect(scaledRegion, this._driverInfo.safeArea) : scaledRegion;
-        const offsetRegion = utils.geometry.offsetNegative(safeRegion, { x: 0, y: this.statusBarHeight });
-        if (offsetRegion.y < 0) {
-            offsetRegion.height += offsetRegion.y;
-            offsetRegion.y = 0;
-        }
-        return offsetRegion;
-    }
-    async getRegionInViewport(context, region) {
-        await context.focus();
-        return context.getRegionInViewport(region);
-    }
-    async element(selector) {
-        return this.currentContext.element(selector);
-    }
-    async elements(selector) {
-        return this.currentContext.elements(selector);
-    }
-    async execute(script, arg) {
-        return this.currentContext.execute(script, arg);
-    }
-    async takeScreenshot() {
-        const image = await this._spec.takeScreenshot(this.target);
-        if (utils.types.isString(image)) {
-            return Buffer.from(image.replace(/[\r\n]+/g, ''), 'base64');
-        }
-        return image;
-    }
-    async getViewportSize() {
-        var _a;
-        let size;
-        if (this.isNative) {
-            this._logger.log('Extracting viewport size from native driver');
-            if ((_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.viewportSize) {
-                size = this._driverInfo.viewportSize;
-            }
-            else {
-                size = await this.getDisplaySize();
-                if (size.height > size.width) {
-                    const orientation = await this.getOrientation();
-                    if (orientation === 'landscape') {
-                        size = { width: size.height, height: size.width };
-                    }
-                }
-            }
-            size = utils.geometry.round(size);
-        }
-        else if (this._spec.getViewportSize) {
-            this._logger.log('Extracting viewport size from web driver using spec method');
-            size = await this._spec.getViewportSize(this.target);
-        }
-        else {
-            this._logger.log('Extracting viewport size from web driver using js snippet');
-            size = await this.mainContext.execute(snippets.getViewportSize);
-        }
-        this._logger.log('Extracted viewport size', size);
-        return size;
-    }
-    async setViewportSize(size) {
-        if (this.isMobile)
-            return;
-        if (this._spec.setViewportSize) {
-            this._logger.log('Setting viewport size to', size, 'using spec method');
-            await this._spec.setViewportSize(this.target, size);
-            return;
-        }
-        this._logger.log('Setting viewport size to', size, 'using workaround');
-        const requiredViewportSize = size;
-        let currentViewportSize = await this.getViewportSize();
-        if (utils.geometry.equals(currentViewportSize, requiredViewportSize))
-            return;
-        let currentWindowSize = await this._spec.getWindowSize(this.target);
-        this._logger.log('Extracted window size', currentWindowSize);
-        let attempt = 0;
-        while (attempt++ < 3) {
-            const requiredWindowSize = {
-                width: currentWindowSize.width + (requiredViewportSize.width - currentViewportSize.width),
-                height: currentWindowSize.height + (requiredViewportSize.height - currentViewportSize.height),
-            };
-            this._logger.log(`Attempt #${attempt} to set viewport size by setting window size to`, requiredWindowSize);
-            await this._spec.setWindowSize(this.target, requiredWindowSize);
-            const prevViewportSize = currentViewportSize;
-            currentViewportSize = await this.getViewportSize();
-            if (utils.geometry.equals(currentViewportSize, prevViewportSize)) {
-                currentViewportSize = await this.getViewportSize();
-            }
-            currentWindowSize = requiredWindowSize;
-            if (utils.geometry.equals(currentViewportSize, requiredViewportSize))
-                return;
-            this._logger.log(`Attempt #${attempt} to set viewport size failed. Current viewport:`, currentViewportSize);
-        }
-        throw new Error('Failed to set viewport size!');
-    }
-    async getDisplaySize() {
-        if (this.isWeb && !this.isMobile)
-            return;
-        const size = await this._spec.getWindowSize(this.target);
-        return this.isAndroid ? utils.geometry.scale(size, 1 / this.pixelRatio) : size;
-    }
-    async getOrientation() {
-        if (this.isWeb && !this.isMobile)
-            return;
-        const orientation = this._spec.getOrientation(this.target);
-        this._logger.log('Extracted device orientation:', orientation);
-        return orientation;
-    }
-    async getCookies() {
-        var _a, _b, _c;
-        if (this.isNative || !this.features.allCookies)
-            return [];
-        try {
-            return (_c = (await ((_b = (_a = this._spec).getCookies) === null || _b === void 0 ? void 0 : _b.call(_a, this.target)))) !== null && _c !== void 0 ? _c : [];
-        }
-        catch (error) {
-            this._driverInfo.features.allCookies = false;
-            throw error;
-        }
-    }
-    async getTitle() {
-        if (this.isNative)
-            return null;
-        const title = await this._spec.getTitle(this.target);
-        this._logger.log('Extracted title:', title);
-        return title;
-    }
-    async getUrl() {
-        if (this.isNative)
-            return null;
-        const url = this._spec.getUrl(this.target);
-        this._logger.log('Extracted url:', url);
-        return url;
-    }
-    async visit(url) {
-        await this._spec.visit(this.target, url);
-    }
-}
-exports.Driver = Driver;
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Driver = void 0;
+const utils = __importStar(require("@applitools/utils"));
+const specUtils = __importStar(require("./spec-utils"));
+const context_1 = require("./context");
+const helper_ios_1 = require("./helper-ios");
+const helper_android_1 = require("./helper-android");
+const user_agent_1 = require("./user-agent");
+const capabilities_1 = require("./capabilities");
+const snippets = require('@applitools/snippets');
+// eslint-disable-next-line
+class Driver {
+    constructor(options) {
+        var _a, _b, _c, _d, _e, _f;
+        if (options.driver instanceof Driver)
+            return options.driver;
+        this._spec = options.spec;
+        if (options.logger)
+            this._logger = options.logger;
+        if (this._spec.isDriver(options.driver)) {
+            this._target = (_c = (_b = (_a = this._spec).transformDriver) === null || _b === void 0 ? void 0 : _b.call(_a, options.driver)) !== null && _c !== void 0 ? _c : options.driver;
+        }
+        else {
+            throw new TypeError('Driver constructor called with argument of unknown type!');
+        }
+        this._mainContext = new context_1.Context({
+            spec: this._spec,
+            context: (_f = (_e = (_d = this._spec).extractContext) === null || _e === void 0 ? void 0 : _e.call(_d, this._target)) !== null && _f !== void 0 ? _f : this._target,
+            driver: this,
+            logger: this._logger,
+        });
+        this._currentContext = this._mainContext;
+    }
+    get target() {
+        return this._target;
+    }
+    get currentContext() {
+        return this._currentContext;
+    }
+    get mainContext() {
+        return this._mainContext;
+    }
+    get helper() {
+        return this._helper;
+    }
+    get features() {
+        var _a;
+        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.features;
+    }
+    get deviceName() {
+        var _a;
+        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.deviceName;
+    }
+    get platformName() {
+        var _a;
+        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.platformName;
+    }
+    get platformVersion() {
+        var _a;
+        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.platformVersion;
+    }
+    get browserName() {
+        var _a;
+        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.browserName;
+    }
+    get browserVersion() {
+        var _a;
+        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.browserVersion;
+    }
+    get userAgent() {
+        var _a;
+        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.userAgent;
+    }
+    get orientation() {
+        return this._driverInfo.orientation;
+    }
+    get pixelRatio() {
+        var _a;
+        return (_a = this._driverInfo.pixelRatio) !== null && _a !== void 0 ? _a : 1;
+    }
+    get viewportScale() {
+        var _a;
+        return (_a = this._driverInfo.viewportScale) !== null && _a !== void 0 ? _a : 1;
+    }
+    get statusBarHeight() {
+        var _a;
+        return (_a = this._driverInfo.statusBarHeight) !== null && _a !== void 0 ? _a : (this.isNative ? 0 : undefined);
+    }
+    get navigationBarHeight() {
+        var _a;
+        return (_a = this._driverInfo.navigationBarHeight) !== null && _a !== void 0 ? _a : (this.isNative ? 0 : undefined);
+    }
+    get isNative() {
+        var _a, _b;
+        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isNative) !== null && _b !== void 0 ? _b : false;
+    }
+    get isWeb() {
+        return !this.isNative;
+    }
+    get isMobile() {
+        var _a, _b;
+        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isMobile) !== null && _b !== void 0 ? _b : false;
+    }
+    get isIOS() {
+        return this.platformName === 'iOS';
+    }
+    get isAndroid() {
+        return this.platformName === 'Android';
+    }
+    get isIE() {
+        return /(internet explorer|ie)/i.test(this.browserName);
+    }
+    get isEdgeLegacy() {
+        return /edge/i.test(this.browserName) && Number(this.browserVersion) <= 44;
+    }
+    updateCurrentContext(context) {
+        this._currentContext = context;
+    }
+    async init() {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
+        var _w, _x, _y, _z, _0, _1, _2, _3;
+        const capabilities = await ((_b = (_a = this._spec).getCapabilities) === null || _b === void 0 ? void 0 : _b.call(_a, this.target));
+        this._logger.log('Driver capabilities', capabilities);
+        const capabilitiesInfo = capabilities ? capabilities_1.parseCapabilities(capabilities) : undefined;
+        const driverInfo = await ((_d = (_c = this._spec).getDriverInfo) === null || _d === void 0 ? void 0 : _d.call(_c, this.target));
+        this._driverInfo = Object.assign(Object.assign({}, capabilitiesInfo), driverInfo);
+        if (this.isWeb) {
+            (_e = (_w = this._driverInfo).pixelRatio) !== null && _e !== void 0 ? _e : (_w.pixelRatio = await this.execute(snippets.getPixelRatio));
+            (_f = (_x = this._driverInfo).viewportScale) !== null && _f !== void 0 ? _f : (_x.viewportScale = await this.execute(snippets.getViewportScale));
+            (_g = (_y = this._driverInfo).userAgent) !== null && _g !== void 0 ? _g : (_y.userAgent = await this.execute(snippets.getUserAgent));
+            if (this._driverInfo.userAgent) {
+                const userAgentInfo = user_agent_1.parseUserAgent(this._driverInfo.userAgent);
+                this._driverInfo.browserName = (_h = userAgentInfo.browserName) !== null && _h !== void 0 ? _h : this._driverInfo.browserName;
+                this._driverInfo.browserVersion = (_j = userAgentInfo.browserVersion) !== null && _j !== void 0 ? _j : this._driverInfo.browserVersion;
+                if (this._driverInfo.isMobile) {
+                    (_k = (_z = this._driverInfo).platformName) !== null && _k !== void 0 ? _k : (_z.platformName = userAgentInfo.platformName);
+                    (_l = (_0 = this._driverInfo).platformVersion) !== null && _l !== void 0 ? _l : (_0.platformVersion = userAgentInfo.platformVersion);
+                }
+                else {
+                    this._driverInfo.platformName = (_m = userAgentInfo.platformName) !== null && _m !== void 0 ? _m : this._driverInfo.platformName;
+                    this._driverInfo.platformVersion = (_o = userAgentInfo.platformVersion) !== null && _o !== void 0 ? _o : this._driverInfo.platformVersion;
+                }
+            }
+            (_p = (_1 = this._driverInfo).features) !== null && _p !== void 0 ? _p : (_1.features = {});
+            (_q = (_2 = this._driverInfo.features).allCookies) !== null && _q !== void 0 ? _q : (_2.allCookies = /chrome/i.test(this._driverInfo.browserName) && !this._driverInfo.isMobile);
+        }
+        else {
+            const barsHeight = await ((_s = (_r = this._spec).getBarsHeight) === null || _s === void 0 ? void 0 : _s.call(_r, this.target).catch(() => undefined));
+            const displaySize = await this.getDisplaySize();
+            // calculate status and navigation bars sizes
+            if (barsHeight) {
+                // when status bar is overlapping content on android it returns status bar height equal to viewport height
+                if (this.isAndroid && barsHeight.statusBarHeight / this.pixelRatio < displaySize.height) {
+                    this._driverInfo.statusBarHeight = Math.max((_t = this._driverInfo.statusBarHeight) !== null && _t !== void 0 ? _t : 0, barsHeight.statusBarHeight);
+                }
+                this._driverInfo.navigationBarHeight = Math.max((_u = this._driverInfo.navigationBarHeight) !== null && _u !== void 0 ? _u : 0, barsHeight.navigationBarHeight);
+            }
+            if (this.isAndroid) {
+                this._driverInfo.statusBarHeight /= this.pixelRatio;
+                this._driverInfo.navigationBarHeight /= this.pixelRatio;
+            }
+            // calculate viewport size
+            if (!this._driverInfo.viewportSize) {
+                this._driverInfo.viewportSize = {
+                    width: displaySize.width,
+                    height: displaySize.height - this._driverInfo.statusBarHeight,
+                };
+            }
+            // calculate safe area
+            if (this.isIOS && !this._driverInfo.safeArea) {
+                this._driverInfo.safeArea = Object.assign({ x: 0, y: 0 }, displaySize);
+                const topElement = await this.element({ type: '-ios class chain', selector: '**/XCUIElementTypeNavigationBar' });
+                if (topElement) {
+                    const topRegion = await this._spec.getElementRegion(this.target, topElement.target);
+                    const topOffset = topRegion.y + topRegion.height;
+                    this._driverInfo.safeArea.y = topOffset;
+                    this._driverInfo.safeArea.height -= topOffset;
+                }
+                const bottomElement = await this.element({ type: '-ios class chain', selector: '**/XCUIElementTypeTabBar' });
+                if (bottomElement) {
+                    const bottomRegion = await this._spec.getElementRegion(this.target, bottomElement.target);
+                    const bottomOffset = bottomRegion.height;
+                    this._driverInfo.safeArea.height -= bottomOffset;
+                }
+            }
+            // init helper lib
+            this._helper = this.isIOS
+                ? await helper_ios_1.HelperIOS.make({ spec: this._spec, driver: this, logger: this._logger })
+                : await helper_android_1.HelperAndroid.make({ spec: this._spec, driver: this, logger: this._logger });
+        }
+        if (this.isMobile) {
+            (_v = (_3 = this._driverInfo).orientation) !== null && _v !== void 0 ? _v : (_3.orientation = await this.getOrientation().catch(() => undefined));
+        }
+        this._logger.log('Combined driver info', this._driverInfo);
+        return this;
+    }
+    async refreshContexts() {
+        if (this.isNative)
+            return this.currentContext;
+        const spec = this._spec;
+        let currentContext = this.currentContext.target;
+        let contextInfo = await getContextInfo(currentContext);
+        const path = [];
+        if (spec.parentContext) {
+            while (!contextInfo.isRoot) {
+                currentContext = await spec.parentContext(currentContext);
+                const contextReference = await findContextReference(currentContext, contextInfo);
+                if (!contextReference)
+                    throw new Error('Unable to find out the chain of frames');
+                path.unshift(contextReference);
+                contextInfo = await getContextInfo(currentContext);
+            }
+        }
+        else {
+            currentContext = await spec.mainContext(currentContext);
+            path.push(...(await findContextPath(currentContext, contextInfo)));
+        }
+        this._currentContext = this._mainContext;
+        return this.switchToChildContext(...path);
+        function transformSelector(selector) {
+            return specUtils.transformSelector(spec, selector, { isWeb: true });
+        }
+        async function getContextInfo(context) {
+            const [documentElement, selector, isRoot, isCORS] = await spec.executeScript(context, snippets.getContextInfo);
+            return { documentElement, selector, isRoot, isCORS };
+        }
+        async function getChildContextsInfo(context) {
+            const framesInfo = await spec.executeScript(context, snippets.getChildFramesInfo);
+            return framesInfo.map(([contextElement, isCORS]) => ({ contextElement, isCORS }));
+        }
+        async function isEqualElements(context, element1, element2) {
+            return spec.executeScript(context, snippets.isEqualElements, [element1, element2]).catch(() => false);
+        }
+        async function findContextReference(context, contextInfo) {
+            if (contextInfo.selector) {
+                const contextElement = await spec.findElement(context, transformSelector({ type: 'xpath', selector: contextInfo.selector }));
+                if (contextElement)
+                    return contextElement;
+            }
+            for (const childContextInfo of await getChildContextsInfo(context)) {
+                if (childContextInfo.isCORS !== contextInfo.isCORS)
+                    continue;
+                const childContext = await spec.childContext(context, childContextInfo.contextElement);
+                const contentDocument = await spec.findElement(childContext, transformSelector('html'));
+                const isWantedContext = await isEqualElements(childContext, contentDocument, contextInfo.documentElement);
+                await spec.parentContext(childContext);
+                if (isWantedContext)
+                    return childContextInfo.contextElement;
+            }
+        }
+        async function findContextPath(context, contextInfo, contextPath = []) {
+            const contentDocument = await spec.findElement(context, transformSelector('html'));
+            if (await isEqualElements(context, contentDocument, contextInfo.documentElement)) {
+                return contextPath;
+            }
+            for (const childContextInfo of await getChildContextsInfo(context)) {
+                const childContext = await spec.childContext(context, childContextInfo.contextElement);
+                const possibleContextPath = [...contextPath, childContextInfo.contextElement];
+                const wantedContextPath = await findContextPath(childContext, contextInfo, possibleContextPath);
+                await spec.mainContext(context);
+                if (wantedContextPath)
+                    return wantedContextPath;
+                for (const contextElement of contextPath) {
+                    await spec.childContext(context, contextElement);
+                }
+            }
+        }
+    }
+    async switchTo(context) {
+        if (await this.currentContext.equals(context)) {
+            this._currentContext = context;
+            return;
+        }
+        const currentPath = this.currentContext.path;
+        const requiredPath = context.path;
+        let diffIndex = -1;
+        for (const [index, context] of requiredPath.entries()) {
+            if (currentPath[index] && !(await currentPath[index].equals(context))) {
+                diffIndex = index;
+                break;
+            }
+        }
+        if (diffIndex === 0) {
+            throw new Error('Cannot switch to the context, because it has different main context');
+        }
+        else if (diffIndex === -1) {
+            if (currentPath.length === requiredPath.length) {
+                // required and current paths are the same
+                return this.currentContext;
+            }
+            else if (requiredPath.length > currentPath.length) {
+                // current path is a sub-path of required path
+                return this.switchToChildContext(...requiredPath.slice(currentPath.length));
+            }
+            else if (currentPath.length - requiredPath.length <= requiredPath.length) {
+                // required path is a sub-path of current path
+                return this.switchToParentContext(currentPath.length - requiredPath.length);
+            }
+            else {
+                // required path is a sub-path of current path
+                await this.switchToMainContext();
+                return this.switchToChildContext(...requiredPath);
+            }
+        }
+        else if (currentPath.length - diffIndex <= diffIndex) {
+            // required path is different from current or they are partially intersected
+            // chose an optimal way to traverse from current context to target context
+            await this.switchToParentContext(currentPath.length - diffIndex);
+            return this.switchToChildContext(...requiredPath.slice(diffIndex));
+        }
+        else {
+            await this.switchToMainContext();
+            return this.switchToChildContext(...requiredPath);
+        }
+    }
+    async switchToMainContext() {
+        if (this.isNative)
+            throw new Error('Contexts are supported only for web drivers');
+        this._logger.log('Switching to the main context');
+        await this._spec.mainContext(this.currentContext.target);
+        return (this._currentContext = this._mainContext);
+    }
+    async switchToParentContext(elevation = 1) {
+        if (this.isNative)
+            throw new Error('Contexts are supported only for web drivers');
+        this._logger.log('Switching to a parent context with elevation:', elevation);
+        if (this.currentContext.path.length <= elevation) {
+            return this.switchToMainContext();
+        }
+        try {
+            while (elevation > 0) {
+                await this._spec.parentContext(this.currentContext.target);
+                this._currentContext = this._currentContext.parent;
+                elevation -= 1;
+            }
+        }
+        catch (err) {
+            this._logger.warn('Unable to switch to a parent context due to error', err);
+            this._logger.log('Applying workaround to switch to the parent frame');
+            const path = this.currentContext.path.slice(1, -elevation);
+            await this.switchToMainContext();
+            await this.switchToChildContext(...path);
+            elevation = 0;
+        }
+        return this.currentContext;
+    }
+    async switchToChildContext(...references) {
+        if (this.isNative)
+            throw new Error('Contexts are supported only for web drivers');
+        this._logger.log('Switching to a child context with depth:', references.length);
+        for (const reference of references) {
+            if (reference === this.mainContext)
+                continue;
+            const context = await this.currentContext.context(reference);
+            await context.focus();
+        }
+        return this.currentContext;
+    }
+    async normalizeRegion(region) {
+        if (this.isWeb || !utils.types.has(this._driverInfo, ['viewportSize', 'statusBarHeight']))
+            return region;
+        const scaledRegion = this.isAndroid ? utils.geometry.scale(region, 1 / this.pixelRatio) : region;
+        const safeRegion = this.isIOS ? utils.geometry.intersect(scaledRegion, this._driverInfo.safeArea) : scaledRegion;
+        const offsetRegion = utils.geometry.offsetNegative(safeRegion, { x: 0, y: this.statusBarHeight });
+        if (offsetRegion.y < 0) {
+            offsetRegion.height += offsetRegion.y;
+            offsetRegion.y = 0;
+        }
+        return offsetRegion;
+    }
+    async getRegionInViewport(context, region) {
+        await context.focus();
+        return context.getRegionInViewport(region);
+    }
+    async element(selector) {
+        return this.currentContext.element(selector);
+    }
+    async elements(selector) {
+        return this.currentContext.elements(selector);
+    }
+    async execute(script, arg) {
+        return this.currentContext.execute(script, arg);
+    }
+    async takeScreenshot() {
+        const image = await this._spec.takeScreenshot(this.target);
+        if (utils.types.isString(image)) {
+            return Buffer.from(image.replace(/[\r\n]+/g, ''), 'base64');
+        }
+        return image;
+    }
+    async getViewportSize() {
+        var _a;
+        let size;
+        if (this.isNative) {
+            this._logger.log('Extracting viewport size from native driver');
+            if ((_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.viewportSize) {
+                size = this._driverInfo.viewportSize;
+            }
+            else {
+                size = await this.getDisplaySize();
+                if (size.height > size.width) {
+                    const orientation = await this.getOrientation();
+                    if (orientation === 'landscape') {
+                        size = { width: size.height, height: size.width };
+                    }
+                }
+            }
+            size = utils.geometry.round(size);
+        }
+        else if (this._spec.getViewportSize) {
+            this._logger.log('Extracting viewport size from web driver using spec method');
+            size = await this._spec.getViewportSize(this.target);
+        }
+        else {
+            this._logger.log('Extracting viewport size from web driver using js snippet');
+            size = await this.mainContext.execute(snippets.getViewportSize);
+        }
+        this._logger.log('Extracted viewport size', size);
+        return size;
+    }
+    async setViewportSize(size) {
+        if (this.isMobile)
+            return;
+        if (this._spec.setViewportSize) {
+            this._logger.log('Setting viewport size to', size, 'using spec method');
+            await this._spec.setViewportSize(this.target, size);
+            return;
+        }
+        this._logger.log('Setting viewport size to', size, 'using workaround');
+        const requiredViewportSize = size;
+        let currentViewportSize = await this.getViewportSize();
+        if (utils.geometry.equals(currentViewportSize, requiredViewportSize))
+            return;
+        let currentWindowSize = await this._spec.getWindowSize(this.target);
+        this._logger.log('Extracted window size', currentWindowSize);
+        let attempt = 0;
+        while (attempt++ < 3) {
+            const requiredWindowSize = {
+                width: currentWindowSize.width + (requiredViewportSize.width - currentViewportSize.width),
+                height: currentWindowSize.height + (requiredViewportSize.height - currentViewportSize.height),
+            };
+            this._logger.log(`Attempt #${attempt} to set viewport size by setting window size to`, requiredWindowSize);
+            await this._spec.setWindowSize(this.target, requiredWindowSize);
+            const prevViewportSize = currentViewportSize;
+            currentViewportSize = await this.getViewportSize();
+            if (utils.geometry.equals(currentViewportSize, prevViewportSize)) {
+                currentViewportSize = await this.getViewportSize();
+            }
+            currentWindowSize = requiredWindowSize;
+            if (utils.geometry.equals(currentViewportSize, requiredViewportSize))
+                return;
+            this._logger.log(`Attempt #${attempt} to set viewport size failed. Current viewport:`, currentViewportSize);
+        }
+        throw new Error('Failed to set viewport size!');
+    }
+    async getDisplaySize() {
+        if (this.isWeb && !this.isMobile)
+            return;
+        const size = await this._spec.getWindowSize(this.target);
+        return this.isAndroid ? utils.geometry.scale(size, 1 / this.pixelRatio) : size;
+    }
+    async getOrientation() {
+        if (this.isWeb && !this.isMobile)
+            return;
+        const orientation = this._spec.getOrientation(this.target);
+        this._logger.log('Extracted device orientation:', orientation);
+        return orientation;
+    }
+    async getCookies() {
+        var _a, _b, _c;
+        if (this.isNative || !this.features.allCookies)
+            return [];
+        try {
+            return (_c = (await ((_b = (_a = this._spec).getCookies) === null || _b === void 0 ? void 0 : _b.call(_a, this.target)))) !== null && _c !== void 0 ? _c : [];
+        }
+        catch (error) {
+            this._driverInfo.features.allCookies = false;
+            throw error;
+        }
+    }
+    async getTitle() {
+        if (this.isNative)
+            return null;
+        const title = await this._spec.getTitle(this.target);
+        this._logger.log('Extracted title:', title);
+        return title;
+    }
+    async getUrl() {
+        if (this.isNative)
+            return null;
+        const url = this._spec.getUrl(this.target);
+        this._logger.log('Extracted url:', url);
+        return url;
+    }
+    async visit(url) {
+        await this._spec.visit(this.target, url);
+    }
+}
+exports.Driver = Driver;