testplane 0.0.1 → 0.1.0

package/build/src/browser/history/utils.js

@@ -0,0 +1,61 @@
+"use strict";
+const _ = require("lodash");
+const MAX_STRING_LENGTH = 50;
+exports.normalizeCommandArgs = (name, args = []) => {
+    if (name === "execute") {
+        return ["code"];
+    }
+    return args.map(arg => {
+        if (_.isString(arg)) {
+            return _.truncate(arg, { length: MAX_STRING_LENGTH });
+        }
+        if (_.isPlainObject(arg)) {
+            return "obj";
+        }
+        return arg;
+    });
+};
+exports.historyDataMap = {
+    NAME: "n",
+    ARGS: "a",
+    SCOPE: "s",
+    DURATION: "d",
+    TIME_START: "ts",
+    TIME_END: "te",
+    IS_OVERWRITTEN: "o",
+    IS_GROUP: "g",
+    IS_FAILED: "f",
+    CHILDREN: "c",
+    KEY: "k",
+};
+const isPromise = val => typeof _.get(val, "then") === "function";
+exports.isGroup = node => Boolean(node && node[exports.historyDataMap.IS_GROUP]);
+exports.runWithHooks = ({ fn, before, after, error }) => {
+    let isReturnedValuePromise = false;
+    before();
+    try {
+        const value = fn();
+        if (isPromise(value)) {
+            isReturnedValuePromise = true;
+            return value
+                .catch(err => {
+                error();
+                throw err;
+            })
+                .finally(after);
+        }
+        return value;
+    }
+    catch (err) {
+        if (!isReturnedValuePromise) {
+            error();
+            throw err;
+        }
+    }
+    finally {
+        if (!isReturnedValuePromise) {
+            after();
+        }
+    }
+};
+//# sourceMappingURL=utils.js.map

package/build/src/browser/history/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/browser/history/utils.js"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE5B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,OAAO,CAAC,oBAAoB,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE;IAC/C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAClB,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,GAAG,CAAC;IACf,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,CAAC,cAAc,GAAG;IACrB,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,IAAI;IACd,cAAc,EAAE,GAAG;IACnB,QAAQ,EAAE,GAAG;IACb,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;IACb,GAAG,EAAE,GAAG;CACX,CAAC;AAEF,MAAM,SAAS,GAAG,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,UAAU,CAAC;AAElE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEjF,OAAO,CAAC,YAAY,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;IACpD,IAAI,sBAAsB,GAAG,KAAK,CAAC;IAEnC,MAAM,EAAE,CAAC;IAET,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,EAAE,EAAE,CAAC;QAEnB,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,sBAAsB,GAAG,IAAI,CAAC;YAE9B,OAAO,KAAK;iBACP,KAAK,CAAC,GAAG,CAAC,EAAE;gBACT,KAAK,EAAE,CAAC;gBAER,MAAM,GAAG,CAAC;YACd,CAAC,CAAC;iBACD,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAC1B,KAAK,EAAE,CAAC;YAER,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC;YAAS,CAAC;QACP,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAC1B,KAAK,EAAE,CAAC;QACZ,CAAC;IACL,CAAC;AACL,CAAC,CAAC"}

package/build/src/browser/new-browser.d.ts

@@ -0,0 +1,32 @@
+export = NewBrowser;
+declare class NewBrowser extends Browser {
+    init(): Promise<this>;
+    reset(): Promise<void>;
+    quit(): Promise<void>;
+    _createSession(): Promise<WebdriverIO.Browser>;
+    _setPageLoadTimeout(): Promise<void>;
+    _getSessionOpts(): {
+        protocol: any;
+        hostname: any;
+        port: number;
+        path: any;
+        queryParams: {
+            [k: string]: string;
+        };
+        capabilities: any;
+        automationProtocol: any;
+        connectionRetryTimeout: any;
+        connectionRetryCount: number;
+        baseUrl: any;
+        waitforTimeout: any;
+        waitforInterval: any;
+    };
+    _extendCapabilities(config: any): any;
+    _addHeadlessCapability(headless: any, capabilities: any): any;
+    _extendCapabilitiesByVersion(): any;
+    _getGridHost(url: any): any;
+    _getQueryParams(query: any): {
+        [k: string]: string;
+    };
+}
+import Browser = require("./browser");

package/build/src/browser/new-browser.js

@@ -0,0 +1,150 @@
+"use strict";
+const { URLSearchParams } = require("url");
+const URI = require("urijs");
+const _ = require("lodash");
+const webdriverio = require("webdriverio");
+const Browser = require("./browser");
+const signalHandler = require("../signal-handler");
+const history = require("./history");
+const logger = require("../utils/logger");
+const RuntimeConfig = require("../config/runtime-config");
+const { DEVTOOLS_PROTOCOL } = require("../constants/config");
+const DEFAULT_PORT = 4444;
+const headlessBrowserOptions = {
+    chrome: {
+        capabilityName: "goog:chromeOptions",
+        getArgs: headlessMode => {
+            const headlessValue = _.isBoolean(headlessMode) ? "headless" : `headless=${headlessMode}`;
+            return [headlessValue, "disable-gpu"];
+        },
+    },
+    firefox: {
+        capabilityName: "moz:firefoxOptions",
+        getArgs: () => ["-headless"],
+    },
+    msedge: {
+        capabilityName: "ms:edgeOptions",
+        getArgs: () => ["--headless"],
+    },
+    edge: {
+        capabilityName: "ms:edgeOptions",
+        getArgs: () => ["--headless"],
+    },
+};
+module.exports = class NewBrowser extends Browser {
+    constructor(config, opts) {
+        super(config, opts);
+        signalHandler.on("exit", () => this.quit());
+    }
+    async init() {
+        this._session = await this._createSession();
+        this._addSteps();
+        this._addHistory();
+        await history.runGroup(this._callstackHistory, "testplane: init browser", async () => {
+            this._addCommands();
+            this.restoreHttpTimeout();
+            await this._setPageLoadTimeout();
+        });
+        return this;
+    }
+    reset() {
+        return Promise.resolve();
+    }
+    async quit() {
+        try {
+            this.setHttpTimeout(this._config.sessionQuitTimeout);
+            await this._session.deleteSession();
+        }
+        catch (e) {
+            logger.warn(`WARNING: Can not close session: ${e.message}`);
+        }
+    }
+    _createSession() {
+        const sessionOpts = this._getSessionOpts();
+        return webdriverio.remote(sessionOpts);
+    }
+    async _setPageLoadTimeout() {
+        if (!this._config.pageLoadTimeout) {
+            return;
+        }
+        try {
+            await this._session.setTimeout({ pageLoad: this._config.pageLoadTimeout });
+        }
+        catch (e) {
+            // edge with w3c does not support setting page load timeout
+            if (this._session.isW3C && this._session.capabilities.browserName === "MicrosoftEdge") {
+                logger.warn(`WARNING: Can not set page load timeout: ${e.message}`);
+            }
+            else {
+                throw e;
+            }
+        }
+    }
+    _getSessionOpts() {
+        const config = this._config;
+        const gridUri = new URI(config.gridUrl);
+        const capabilities = this._extendCapabilities(config);
+        const { devtools } = RuntimeConfig.getInstance();
+        const options = {
+            protocol: gridUri.protocol(),
+            hostname: this._getGridHost(gridUri),
+            port: gridUri.port() ? parseInt(gridUri.port(), 10) : DEFAULT_PORT,
+            path: gridUri.path(),
+            queryParams: this._getQueryParams(gridUri.query()),
+            capabilities,
+            automationProtocol: devtools ? DEVTOOLS_PROTOCOL : config.automationProtocol,
+            connectionRetryTimeout: config.sessionRequestTimeout || config.httpTimeout,
+            connectionRetryCount: 0, // testplane has its own advanced retries
+            baseUrl: config.baseUrl,
+            waitforTimeout: config.waitTimeout,
+            waitforInterval: config.waitInterval,
+            ...this._getSessionOptsFromConfig(),
+        };
+        return options;
+    }
+    _extendCapabilities(config) {
+        const capabilitiesExtendedByVersion = this.version
+            ? this._extendCapabilitiesByVersion()
+            : config.desiredCapabilities;
+        const capabilitiesWithAddedHeadless = this._addHeadlessCapability(config.headless, capabilitiesExtendedByVersion);
+        return capabilitiesWithAddedHeadless;
+    }
+    _addHeadlessCapability(headless, capabilities) {
+        if (!headless) {
+            return capabilities;
+        }
+        const capabilitySettings = headlessBrowserOptions[capabilities.browserName];
+        if (!capabilitySettings) {
+            logger.warn(`WARNING: Headless setting is not supported for ${capabilities.browserName} browserName`);
+            return capabilities;
+        }
+        const browserCapabilities = capabilities[capabilitySettings.capabilityName] ?? {};
+        capabilities[capabilitySettings.capabilityName] = {
+            ...browserCapabilities,
+            args: [...(browserCapabilities.args ?? []), ...capabilitySettings.getArgs(headless)],
+        };
+        return capabilities;
+    }
+    _extendCapabilitiesByVersion() {
+        const { desiredCapabilities, sessionEnvFlags } = this._config;
+        const versionKeyName = desiredCapabilities.browserVersion || sessionEnvFlags.isW3C ? "browserVersion" : "version";
+        return _.assign({}, desiredCapabilities, { [versionKeyName]: this.version });
+    }
+    _getGridHost(url) {
+        return new URI({
+            username: url.username(),
+            password: url.password(),
+            hostname: url.hostname(),
+        })
+            .toString()
+            .slice(2); // URIjs leaves `//` prefix, removing it
+    }
+    _getQueryParams(query) {
+        if (_.isEmpty(query)) {
+            return {};
+        }
+        const urlParams = new URLSearchParams(query);
+        return Object.fromEntries(urlParams);
+    }
+};
+//# sourceMappingURL=new-browser.js.map

package/build/src/browser/new-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-browser.js","sourceRoot":"","sources":["../../../src/browser/new-browser.js"],"names":[],"mappings":"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"}

package/build/src/browser/screen-shooter/index.d.ts

@@ -0,0 +1,9 @@
+export = ScreenShooter;
+declare class ScreenShooter {
+    static create(browser: any): import(".");
+    constructor(browser: any);
+    _browser: any;
+    capture(page: any, opts?: {}): Promise<any>;
+    _extendScreenshot(viewport: any, page: any, opts: any): Promise<any>;
+    _extendImage(viewport: any, page: any, opts: any): Promise<void>;
+}

package/build/src/browser/screen-shooter/index.js

@@ -0,0 +1,36 @@
+"use strict";
+const Viewport = require("./viewport");
+module.exports = class ScreenShooter {
+    static create(browser) {
+        return new this(browser);
+    }
+    constructor(browser) {
+        this._browser = browser;
+    }
+    async capture(page, opts = {}) {
+        const { allowViewportOverflow, compositeImage, screenshotDelay, selectorToScroll } = opts;
+        const viewportOpts = { allowViewportOverflow, compositeImage };
+        const cropImageOpts = { screenshotDelay, compositeImage, selectorToScroll };
+        const capturedImage = await this._browser.captureViewportImage(page, screenshotDelay);
+        const viewport = Viewport.create(page, capturedImage, viewportOpts);
+        await viewport.handleImage(capturedImage);
+        return this._extendScreenshot(viewport, page, cropImageOpts);
+    }
+    async _extendScreenshot(viewport, page, opts) {
+        let shouldExtend = viewport.validate(this._browser);
+        while (shouldExtend) {
+            await this._extendImage(viewport, page, opts);
+            shouldExtend = viewport.validate(this._browser);
+        }
+        return viewport.composite();
+    }
+    async _extendImage(viewport, page, opts) {
+        const physicalScrollHeight = Math.min(viewport.getVerticalOverflow(), page.viewport.height);
+        const logicalScrollHeight = Math.ceil(physicalScrollHeight / page.pixelRatio);
+        await this._browser.scrollBy({ x: 0, y: logicalScrollHeight, selector: opts.selectorToScroll });
+        page.viewport.top += physicalScrollHeight;
+        const newImage = await this._browser.captureViewportImage(page, opts.screenshotDelay);
+        await viewport.extendBy(physicalScrollHeight, newImage);
+    }
+};
+//# sourceMappingURL=index.js.map

package/build/src/browser/screen-shooter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/browser/screen-shooter/index.js"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAEvC,MAAM,CAAC,OAAO,GAAG,MAAM,aAAa;IAChC,MAAM,CAAC,MAAM,CAAC,OAAO;QACjB,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,YAAY,OAAO;QACf,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE;QACzB,MAAM,EAAE,qBAAqB,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;QAC1F,MAAM,YAAY,GAAG,EAAE,qBAAqB,EAAE,cAAc,EAAE,CAAC;QAC/D,MAAM,aAAa,GAAG,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;QAE5E,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACtF,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;QACpE,MAAM,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAE1C,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI;QACxC,IAAI,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEpD,OAAO,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAE9C,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,QAAQ,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI;QACnC,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5F,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QAE9E,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAEhG,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,oBAAoB,CAAC;QAE1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAEtF,MAAM,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IAC5D,CAAC;CACJ,CAAC"}

package/build/src/browser/screen-shooter/viewport/coord-validator/errors/height-viewport-error.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Height of the element is larger than viewport
+ */
+export declare class HeightViewportError extends Error {
+    constructor(message: string);
+}

package/build/src/browser/screen-shooter/viewport/coord-validator/errors/height-viewport-error.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeightViewportError = void 0;
+/**
+ * Height of the element is larger than viewport
+ */
+class HeightViewportError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+    }
+}
+exports.HeightViewportError = HeightViewportError;
+//# sourceMappingURL=height-viewport-error.js.map

package/build/src/browser/screen-shooter/viewport/coord-validator/errors/height-viewport-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"height-viewport-error.js","sourceRoot":"","sources":["../../../../../../../src/browser/screen-shooter/viewport/coord-validator/errors/height-viewport-error.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACtC,CAAC;CACJ;AAND,kDAMC"}

package/build/src/browser/screen-shooter/viewport/coord-validator/errors/offset-viewport-error.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Position of an element is outside of a viewport left, top or right bounds
+ */
+export declare class OffsetViewportError extends Error {
+    constructor(message: string);
+}

package/build/src/browser/screen-shooter/viewport/coord-validator/errors/offset-viewport-error.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OffsetViewportError = void 0;
+/**
+ * Position of an element is outside of a viewport left, top or right bounds
+ */
+class OffsetViewportError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+    }
+}
+exports.OffsetViewportError = OffsetViewportError;
+//# sourceMappingURL=offset-viewport-error.js.map

package/build/src/browser/screen-shooter/viewport/coord-validator/errors/offset-viewport-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offset-viewport-error.js","sourceRoot":"","sources":["../../../../../../../src/browser/screen-shooter/viewport/coord-validator/errors/offset-viewport-error.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACtC,CAAC;CACJ;AAND,kDAMC"}

package/build/src/browser/screen-shooter/viewport/coord-validator/index.d.ts

@@ -0,0 +1,43 @@
+export = CoordValidator;
+declare class CoordValidator {
+    static create(...args: any[]): import(".");
+    /**
+     * @param {Browser} browser session instance
+     * @param {Object} opts
+     * @param {Boolean} [opts.allowViewportOverflow] ignore OffsetViewportError
+     * @param {Boolean} [opts.compositeImage] allow area bottom bound to be outside of viewport
+     */
+    constructor(browser: Browser, opts?: {
+        allowViewportOverflow?: boolean | undefined;
+        compositeImage?: boolean | undefined;
+    });
+    _log: any;
+    _opts: {
+        allowViewportOverflow?: boolean | undefined;
+        compositeImage?: boolean | undefined;
+    };
+    /**
+     * Validates compatibility of viewport and crop area coordinates
+     * @param {Object} viewport
+     * @param {Object} cropArea
+     */
+    validate(viewport: Object, cropArea: Object): true | HeightViewportError | OffsetViewportError | undefined;
+    /**
+     * Reports error if crop area is outside of viewport
+     * @returns {OffsetViewportError}
+     * @private
+     */
+    private _reportOffsetViewportError;
+    /**
+     * This case is handled specially because of Opera 12 browser.
+     * Problem, described in error message occurs there much more often then
+     * for other browsers and has different workaround
+     * @param {Object} viewport
+     * @param {Object} cropArea - crop area
+     * @returns {HeightViewportError}
+     * @private
+     */
+    private _reportHeightViewportError;
+}
+import { HeightViewportError } from "./errors/height-viewport-error";
+import { OffsetViewportError } from "./errors/offset-viewport-error";

package/build/src/browser/screen-shooter/viewport/coord-validator/index.js

@@ -0,0 +1,76 @@
+"use strict";
+const debug = require("debug");
+const { HeightViewportError } = require("./errors/height-viewport-error");
+const { OffsetViewportError } = require("./errors/offset-viewport-error");
+const isOutsideOfViewport = (viewport, cropArea) => cropArea.top < 0 || cropArea.left < 0 || cropArea.left + cropArea.width > viewport.width;
+module.exports = class CoordValidator {
+    static create(...args) {
+        return new CoordValidator(...args);
+    }
+    /**
+     * @param {Browser} browser session instance
+     * @param {Object} opts
+     * @param {Boolean} [opts.allowViewportOverflow] ignore OffsetViewportError
+     * @param {Boolean} [opts.compositeImage] allow area bottom bound to be outside of viewport
+     */
+    constructor(browser, opts = {}) {
+        this._log = debug("coord-validator:" + browser.id);
+        this._opts = opts;
+    }
+    /**
+     * Validates compatibility of viewport and crop area coordinates
+     * @param {Object} viewport
+     * @param {Object} cropArea
+     */
+    validate(viewport, cropArea) {
+        this._log("viewport size", viewport);
+        this._log("crop area", cropArea);
+        if (this._opts.allowViewportOverflow && !this._opts.compositeImage) {
+            return;
+        }
+        if (!this._opts.allowViewportOverflow && isOutsideOfViewport(viewport, cropArea)) {
+            return this._reportOffsetViewportError();
+        }
+        if (cropArea.top + cropArea.height > viewport.top + viewport.height) {
+            return this._opts.compositeImage || this._reportHeightViewportError(viewport, cropArea);
+        }
+    }
+    /**
+     * Reports error if crop area is outside of viewport
+     * @returns {OffsetViewportError}
+     * @private
+     */
+    _reportOffsetViewportError() {
+        this._log("crop area is outside of the viewport left, top or right bounds");
+        const message = `Can not capture the specified region of the viewport.
+            Position of the region is outside of the viewport left, top or right bounds.
+            Check that elements:
+             - does not overflows the document
+             - does not overflows browser viewport
+            Alternatively, you can increase browser window size using
+            "setWindowSize" or "windowSize" option in the config file.
+            But if viewport overflow is expected behavior then you can use
+            option "allowViewportOverflow" in "assertView" command.`;
+        throw new OffsetViewportError(message);
+    }
+    /**
+     * This case is handled specially because of Opera 12 browser.
+     * Problem, described in error message occurs there much more often then
+     * for other browsers and has different workaround
+     * @param {Object} viewport
+     * @param {Object} cropArea - crop area
+     * @returns {HeightViewportError}
+     * @private
+     */
+    _reportHeightViewportError(viewport, cropArea) {
+        this._log("crop area bottom bound is outside of the viewport height");
+        const message = `Can not capture the specified region of the viewport.
+            The region bottom bound is outside of the viewport height.
+            Alternatively, you can test such cases by setting "true" value to option "compositeImage" in the config file
+            or setting "false" to "compositeImage" and "true" to option "allowViewportOverflow" in "assertView" command.
+            Element position: ${cropArea.left}, ${cropArea.top}; size: ${cropArea.width}, ${cropArea.height}.
+            Viewport size: ${viewport.width}, ${viewport.height}.`;
+        throw new HeightViewportError(message);
+    }
+};
+//# sourceMappingURL=index.js.map

package/build/src/browser/screen-shooter/viewport/coord-validator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/browser/screen-shooter/viewport/coord-validator/index.js"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAC/B,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAAC;AAC1E,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAAC;AAE1E,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAC/C,QAAQ,CAAC,GAAG,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;AAE7F,MAAM,CAAC,OAAO,GAAG,MAAM,cAAc;IACjC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI;QACjB,OAAO,IAAI,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,YAAY,OAAO,EAAE,IAAI,GAAG,EAAE;QAC1B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,kBAAkB,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ;QACvB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAEjC,IAAI,IAAI,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;YACjE,OAAO;QACX,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB,IAAI,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC/E,OAAO,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAC7C,CAAC;QAED,IAAI,QAAQ,CAAC,GAAG,GAAG,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;YAClE,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,IAAI,CAAC,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5F,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,0BAA0B;QACtB,IAAI,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;QAE5E,MAAM,OAAO,GAAG;;;;;;;;oEAQ4C,CAAC;QAE7D,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;OAQG;IACH,0BAA0B,CAAC,QAAQ,EAAE,QAAQ;QACzC,IAAI,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QAEtE,MAAM,OAAO,GAAG;;;;gCAIQ,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,GAAG,WAAW,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,MAAM;6BAC9E,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC;QAE3D,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;CACJ,CAAC"}

package/build/src/browser/screen-shooter/viewport/index.d.ts

@@ -0,0 +1,56 @@
+export = Viewport;
+declare class Viewport {
+    static create(...args: any[]): import(".");
+    constructor(page: any, image: any, opts: any);
+    _viewport: any;
+    _captureArea: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    _ignoreAreas: any;
+    _image: any;
+    _opts: any;
+    _summaryHeight: number;
+    validate(browser: any): true | import("./coord-validator/errors/height-viewport-error").HeightViewportError | import("./coord-validator/errors/offset-viewport-error").OffsetViewportError | undefined;
+    ignoreAreas(image: any, imageArea: any): Promise<void>;
+    handleImage(image: any, area?: {}): Promise<void>;
+    composite(): Promise<any>;
+    save(path: any): Promise<any>;
+    extendBy(physicalScrollHeight: any, newImage: any): Promise<void>;
+    getVerticalOverflow(): number;
+    _sanitize(area: any): {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    _getIntersection(...areas: any[]): {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    } | null;
+    _shiftArea(area: any, { left, top }?: {
+        left: any;
+        top: any;
+    }): {
+        left: any;
+        top: any;
+        width: any;
+        height: any;
+    };
+    _transformToCaptureArea(area: any): {
+        left: any;
+        top: any;
+        width: any;
+        height: any;
+    };
+    _transformToViewportOrigin(area: any): {
+        left: any;
+        top: any;
+        width: any;
+        height: any;
+    };
+}

package/build/src/browser/screen-shooter/viewport/index.js

@@ -0,0 +1,104 @@
+"use strict";
+const _ = require("lodash");
+const CoordValidator = require("./coord-validator");
+module.exports = class Viewport {
+    static create(...args) {
+        return new this(...args);
+    }
+    constructor(page, image, opts) {
+        this._viewport = _.clone(page.viewport);
+        this._captureArea = this._sanitize(page.captureArea);
+        this._ignoreAreas = page.ignoreAreas;
+        this._image = image;
+        this._opts = opts;
+        this._summaryHeight = 0;
+    }
+    validate(browser) {
+        const coordValidator = CoordValidator.create(browser, this._opts);
+        return coordValidator.validate(this._viewport, this._captureArea);
+    }
+    async ignoreAreas(image, imageArea) {
+        for (const area of this._ignoreAreas) {
+            const imageClearArea = this._getIntersection(area, imageArea);
+            if (imageClearArea !== null) {
+                await image.addClear(this._shiftArea(imageClearArea, { left: -imageArea.left, top: -imageArea.top }));
+            }
+        }
+        image.applyClear();
+    }
+    async handleImage(image, area = {}) {
+        const { width, height } = await image.getSize();
+        _.defaults(area, { left: 0, top: 0, width, height });
+        const capturedArea = this._transformToCaptureArea(area);
+        await this.ignoreAreas(image, this._shiftArea(capturedArea, { left: -area.left, top: -area.top }));
+        await image.crop(this._sanitize(this._transformToViewportOrigin(capturedArea)));
+        this._summaryHeight += capturedArea.height;
+    }
+    async composite() {
+        await this._image.applyJoin();
+        return this._image;
+    }
+    async save(path) {
+        return this._image.save(path);
+    }
+    async extendBy(physicalScrollHeight, newImage) {
+        this._viewport.height += physicalScrollHeight;
+        const { width, height } = await newImage.getSize();
+        await this.handleImage(newImage, {
+            left: 0,
+            top: height - physicalScrollHeight,
+            width,
+            height: physicalScrollHeight,
+        });
+        this._image.addJoin(newImage);
+    }
+    getVerticalOverflow() {
+        return getAreaBottom(this._captureArea) - getAreaBottom(this._viewport);
+    }
+    _sanitize(area) {
+        return {
+            left: Math.max(area.left, 0),
+            top: Math.max(area.top, 0),
+            width: Math.max(area.width, 0),
+            height: Math.max(area.height, 0),
+        };
+    }
+    _getIntersection(...areas) {
+        const top = Math.max(...areas.map(area => area.top));
+        const bottom = Math.min(...areas.map(getAreaBottom));
+        const left = Math.max(...areas.map(area => area.left));
+        const right = Math.min(...areas.map(getAreaRight));
+        if (left >= right || top >= bottom) {
+            return null;
+        }
+        return { left, top, width: right - left, height: bottom - top };
+    }
+    _shiftArea(area, { left, top } = {}) {
+        left = left || 0;
+        top = top || 0;
+        return {
+            left: area.left + left,
+            top: area.top + top,
+            width: area.width,
+            height: area.height,
+        };
+    }
+    _transformToCaptureArea(area) {
+        const shiftX = area.left - this._viewport.left;
+        const shiftY = area.top - this._viewport.top;
+        const shiftedImageArea = this._shiftArea(area, { top: this._summaryHeight });
+        const shiftedCaptureArea = this._sanitize(this._shiftArea(this._captureArea, { left: shiftX, top: shiftY }));
+        const intersectingArea = this._getIntersection(shiftedImageArea, shiftedCaptureArea) || shiftedImageArea;
+        return this._shiftArea(intersectingArea, { left: this._viewport.left, top: this._viewport.top });
+    }
+    _transformToViewportOrigin(area) {
+        return this._shiftArea(area, { left: -this._viewport.left, top: -this._viewport.top - this._summaryHeight });
+    }
+};
+function getAreaBottom(area) {
+    return area.top + area.height;
+}
+function getAreaRight(area) {
+    return area.left + area.width;
+}
+//# sourceMappingURL=index.js.map