@gravity-ui/playwright-tools 0.4.1

package/data/globalSettings.d.ts

@@ -0,0 +1,100 @@
+import type { Config } from '../actions/collectPageActivity';
+import type { OnBeforeScreenshotCallback, OnSwitchThemeCallback, ScreenshotOptions, Theme } from '../actions/matchScreenshot';
+/**
+ * Global settings for commands
+ */
+export declare const globalSettings: {
+    /**
+     * actions/assertElementsHidden
+     */
+    assertElementsHidden: {
+        defaultWaitForVisibleTimeout: number;
+    };
+    /**
+     * actions/matchScreenshot
+     */
+    matchScreenshot: {
+        /**
+         * Screenshot creation and comparison parameters.
+         * Will be merged with those passed during the call.
+         */
+        options: ScreenshotOptions;
+        /**
+         * CSS selectors (pure CSS) of elements to hide.
+         * Will be merged with those passed in the call.
+         */
+        hideBySelector: string[] | undefined;
+        /**
+         * Pause before screenshot (ms)
+         */
+        pause: number;
+        /**
+         * Use soft assertion
+         */
+        soft: boolean;
+        /**
+         * Default screenshot name
+         */
+        name: string | undefined;
+        /**
+         * Should I add a slug to the screenshot file name?
+         */
+        shouldPrependSlugToName: boolean;
+        /**
+         * Topics that require a screenshot
+         * By default, screenshots are taken for the current theme. Switching does not occur
+         */
+        themes: Theme[] | undefined;
+        /**
+         * Callback before taking a screenshot. Useful for any special stabilizing actions
+         * @param page Page Current page
+         */
+        onBeforeScreenshot: OnBeforeScreenshotCallback | undefined;
+        /**
+         * Callback to switch theme to pages before taking screenshot
+         * By default, switches the theme using `page.emulateMedia({ colorScheme: theme });`
+         * @param theme Theme The theme for which the screenshot will be taken
+         * @param page Page Current page
+         */
+        onSwitchTheme: undefined | OnSwitchThemeCallback;
+    };
+    /**
+     * actions/mockDate
+     */
+    mockDate: {
+        /**
+         * Default date
+         */
+        defaultDate: {
+            year: number;
+            month: number;
+            day: number;
+            hour: number;
+            min: number;
+            sec: number;
+        };
+    };
+    /**
+     * utils/waitForResolve
+     */
+    waitForResolve: {
+        /**
+         * Interval between checks (ms)
+         */
+        interval: number;
+        /**
+         * Timeout after which checks are aborted (ms)
+         * `0` — without timeout
+         */
+        timeout: number;
+    };
+    collectPageActivity: Pick<Required<Config>, "ignoredMessageTypes" | "expectedMessages" | "ignoredResponseStatuses" | "expectedResponses" | "requestIdHeader">;
+    waitForNetworkSettled: {
+        /** Timeout time after request */
+        delay: number;
+    };
+};
+export type GlobalSettings = typeof globalSettings;
+export type PartialGlobalSettings = {
+    [Key in keyof GlobalSettings]?: Partial<GlobalSettings[Key]>;
+};

package/data/globalSettings.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalSettings = void 0;
+const constants_1 = require("../actions/collectPageActivity/constants");
+const collectPageActivity = {
+    ignoredMessageTypes: constants_1.defaultIgnoredMessageTypes,
+    expectedMessages: [
+        {
+            type: 'error',
+            text: /^Failed to load resource: the server responded with a status of/,
+        },
+    ],
+    ignoredResponseStatuses: constants_1.defaultIgnoredResponseStatuses,
+    expectedResponses: [],
+    requestIdHeader: 'x-request-id',
+};
+/**
+ * Global settings for commands
+ */
+exports.globalSettings = {
+    /**
+     * actions/assertElementsHidden
+     */
+    assertElementsHidden: {
+        defaultWaitForVisibleTimeout: 300,
+    },
+    /**
+     * actions/matchScreenshot
+     */
+    matchScreenshot: {
+        /**
+         * Screenshot creation and comparison parameters.
+         * Will be merged with those passed during the call.
+         */
+        options: {},
+        /**
+         * CSS selectors (pure CSS) of elements to hide.
+         * Will be merged with those passed in the call.
+         */
+        hideBySelector: undefined,
+        /**
+         * Pause before screenshot (ms)
+         */
+        pause: 1000,
+        /**
+         * Use soft assertion
+         */
+        soft: true,
+        /**
+         * Default screenshot name
+         */
+        name: 'plain',
+        /**
+         * Should I add a slug to the screenshot file name?
+         */
+        shouldPrependSlugToName: true,
+        /**
+         * Topics that require a screenshot
+         * By default, screenshots are taken for the current theme. Switching does not occur
+         */
+        themes: undefined,
+        /**
+         * Callback before taking a screenshot. Useful for any special stabilizing actions
+         * @param page Page Current page
+         */
+        onBeforeScreenshot: undefined,
+        /**
+         * Callback to switch theme to pages before taking screenshot
+         * By default, switches the theme using `page.emulateMedia({ colorScheme: theme });`
+         * @param theme Theme The theme for which the screenshot will be taken
+         * @param page Page Current page
+         */
+        onSwitchTheme: (async (theme, page) => {
+            await page.emulateMedia({ colorScheme: theme });
+        }),
+    },
+    /**
+     * actions/mockDate
+     */
+    mockDate: {
+        /**
+         * Default date
+         */
+        defaultDate: {
+            year: 2020,
+            month: 7,
+            day: 15,
+            hour: 12,
+            min: 0,
+            sec: 0,
+        },
+    },
+    /**
+     * utils/waitForResolve
+     */
+    waitForResolve: {
+        /**
+         * Interval between checks (ms)
+         */
+        interval: 100,
+        /**
+         * Timeout after which checks are aborted (ms)
+         * `0` — without timeout
+         */
+        timeout: 5000,
+    },
+    collectPageActivity,
+    waitForNetworkSettled: {
+        /** Timeout time after request */
+        delay: 0,
+    },
+};

package/data/storageStates.d.ts

@@ -0,0 +1,36 @@
+import type { BrowserContext } from '@playwright/test';
+export type StorageState = Awaited<ReturnType<BrowserContext['storageState']>>;
+/**
+ * Adds a snapshot to the repository
+ */
+export declare function setState(key: string, state: StorageState): void;
+/**
+ * Returns a snapshot from storage
+ */
+export declare function getState(key: string): Promise<{
+    cookies: Array<{
+        name: string;
+        value: string;
+        domain: string;
+        path: string;
+        expires: number;
+        httpOnly: boolean;
+        secure: boolean;
+        sameSite: "Strict" | "Lax" | "None";
+    }>;
+    origins: Array<{
+        origin: string;
+        localStorage: Array<{
+            name: string;
+            value: string;
+        }>;
+    }>;
+} | undefined>;
+/**
+ * Checks if a snapshot is in the repository
+ */
+export declare function hasState(key: string): Promise<boolean>;
+/**
+ * Deletes a snapshot from storage
+ */
+export declare function deleteState(key: string): void;

package/data/storageStates.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setState = setState;
+exports.getState = getState;
+exports.hasState = hasState;
+exports.deleteState = deleteState;
+const deleteCache_1 = require("../utils/deleteCache");
+const readCache_1 = require("../utils/readCache");
+const writeCache_1 = require("../utils/writeCache");
+const cacheSettings_1 = require("./cacheSettings");
+/**
+ * Browser Storage Snapshots
+ */
+const storageStates = new Map();
+/**
+ * Adds a snapshot to the repository
+ */
+function setState(key, state) {
+    storageStates.set(key, state);
+    if (cacheSettings_1.cacheSettings.auth.path) {
+        void (0, writeCache_1.writeCache)(cacheSettings_1.cacheSettings.auth.path, key, state).catch((error) => console.warn(error));
+    }
+}
+/**
+ * Returns a snapshot from storage
+ */
+async function getState(key) {
+    if (!storageStates.has(key) && cacheSettings_1.cacheSettings.auth.path) {
+        const state = await (0, readCache_1.readCache)(cacheSettings_1.cacheSettings.auth.path, key, cacheSettings_1.cacheSettings.auth.ttl);
+        if (state) {
+            storageStates.set(key, state);
+        }
+    }
+    return storageStates.get(key);
+}
+/**
+ * Checks if a snapshot is in the repository
+ */
+async function hasState(key) {
+    return Boolean(await getState(key));
+}
+/**
+ * Deletes a snapshot from storage
+ */
+function deleteState(key) {
+    storageStates.delete(key);
+    if (cacheSettings_1.cacheSettings.auth.path) {
+        void (0, deleteCache_1.deleteCache)(cacheSettings_1.cacheSettings.auth.path, key);
+    }
+}

package/data/testSlugs.d.ts

@@ -0,0 +1,5 @@
+import type { Page } from '@playwright/test';
+/**
+ * Storage of test slugs by test page
+ */
+export declare const testSlugs: WeakMap<Page, string>;

package/data/testSlugs.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testSlugs = void 0;
+/**
+ * Storage of test slugs by test page
+ */
+exports.testSlugs = new WeakMap();

package/fixtures/expect-request/expect-request-fixture.d.ts

@@ -0,0 +1,8 @@
+import type { PlaywrightTestArgs, PlaywrightTestOptions, TestFixture } from '@playwright/test';
+import type { ExpectRequestFn } from './types';
+export declare const expectRequestFixture: TestFixture<ExpectRequestFn, PlaywrightTestOptions & PlaywrightTestArgs>;
+declare const fixtureOptions: {
+    readonly scope: "test";
+};
+export declare const expectRequest: [typeof expectRequestFixture, typeof fixtureOptions];
+export {};

package/fixtures/expect-request/expect-request-fixture.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expectRequest = exports.expectRequestFixture = void 0;
+const expect_request_1 = require("../../actions/expect-request");
+const expectRequestFixture = async ({ page, baseURL }, use) => {
+    if (!baseURL) {
+        throw new Error('Base URL required for requests matching!');
+    }
+    const requests = new Map();
+    page.on('request', (request) => {
+        const url = new URL(request.url());
+        const key = `${url.protocol}//${url.hostname}${url.pathname}`;
+        requests.set(key, request);
+    });
+    const boundExpectRequest = expect_request_1.expectRequest.bind(null, requests);
+    await use(boundExpectRequest);
+    requests.clear();
+};
+exports.expectRequestFixture = expectRequestFixture;
+const fixtureOptions = {
+    scope: 'test',
+};
+exports.expectRequest = [
+    exports.expectRequestFixture,
+    fixtureOptions,
+];

package/fixtures/expect-request/index.d.ts

@@ -0,0 +1,3 @@
+export type { ExpectRequestFn, ExpectRequestTestArgs } from './types';
+export type { ExpectRequestFnMatcher, ExpectRequestFnOptions } from '../../actions/expect-request';
+export { expectRequest } from './expect-request-fixture';

package/fixtures/expect-request/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expectRequest = void 0;
+var expect_request_fixture_1 = require("./expect-request-fixture");
+Object.defineProperty(exports, "expectRequest", { enumerable: true, get: function () { return expect_request_fixture_1.expectRequest; } });

package/fixtures/expect-request/types.d.ts

@@ -0,0 +1,5 @@
+import type { ExpectRequestFnMatcher, ExpectRequestFnOptions } from '../../actions/expect-request';
+export type ExpectRequestFn = (url: string | RegExp, matcher?: ExpectRequestFnMatcher, options?: ExpectRequestFnOptions) => Promise<void>;
+export interface ExpectRequestTestArgs {
+    expectRequest: ExpectRequestFn;
+}

package/fixtures/expect-request/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/fixtures/expect-screenshot/expect-screenshot-fixture.d.ts

@@ -0,0 +1,5 @@
+import type { PlaywrightTestArgs, PlaywrightTestOptions, TestFixture } from '@playwright/test';
+import type { ExpectScreenshotFixtureBuilderParams, ExpectScreenshotFn } from './types';
+export declare function expectScreenshotFixtureBuilder({ screenshotOptions, getDefaultMask, ...restDefaults }?: ExpectScreenshotFixtureBuilderParams): [TestFixture<ExpectScreenshotFn, PlaywrightTestArgs & PlaywrightTestOptions>, {
+    scope: "test";
+}];

package/fixtures/expect-screenshot/expect-screenshot-fixture.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expectScreenshotFixtureBuilder = expectScreenshotFixtureBuilder;
+const matchScreenshot_1 = require("../../actions/matchScreenshot");
+function expectScreenshotFixtureBuilder({ screenshotOptions, getDefaultMask, ...restDefaults } = {}) {
+    const expectScreenshotFixture = async ({ page }, use) => {
+        const expectScreenshot = ({ options = {}, shouldUseDefaultMask = true, ...restParams } = {}) => {
+            const { mask = [] } = options;
+            const defaultMask = shouldUseDefaultMask && getDefaultMask ? getDefaultMask(page) : [];
+            const maskToUse = [...mask, ...defaultMask];
+            const mergedOptions = {
+                options: { ...screenshotOptions, ...options, mask: maskToUse },
+                ...restDefaults,
+                ...restParams,
+            };
+            return (0, matchScreenshot_1.matchScreenshot)(page, mergedOptions);
+        };
+        await use(expectScreenshot);
+    };
+    const fixtureOptions = {
+        scope: 'test',
+    };
+    const expectScreenshot = [
+        expectScreenshotFixture,
+        fixtureOptions,
+    ];
+    return expectScreenshot;
+}

package/fixtures/expect-screenshot/index.d.ts

@@ -0,0 +1,2 @@
+export { expectScreenshotFixtureBuilder } from './expect-screenshot-fixture';
+export type { ExpectScreenshotFixtureBuilderParams, ExpectScreenshotFn, ExpectScreenshotTestArgs, } from './types';

package/fixtures/expect-screenshot/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expectScreenshotFixtureBuilder = void 0;
+var expect_screenshot_fixture_1 = require("./expect-screenshot-fixture");
+Object.defineProperty(exports, "expectScreenshotFixtureBuilder", { enumerable: true, get: function () { return expect_screenshot_fixture_1.expectScreenshotFixtureBuilder; } });

package/fixtures/expect-screenshot/types.d.ts

@@ -0,0 +1,14 @@
+import type { Locator, Page } from '@playwright/test';
+import type { MatchScreenshotOptions, ScreenshotOptions } from '../../actions/matchScreenshot';
+export type DefaultScreenshotOptions = Omit<ScreenshotOptions, 'mask'>;
+export type ExpectScreenshotOptions = MatchScreenshotOptions & {
+    shouldUseDefaultMask?: boolean;
+};
+export type ExpectScreenshotFixtureBuilderParams = Pick<MatchScreenshotOptions, 'hideBySelector' | 'pause' | 'soft' | 'shouldPrependSlugToName' | 'themes' | 'onBeforeScreenshot' | 'onSwitchTheme'> & {
+    screenshotOptions?: DefaultScreenshotOptions;
+    getDefaultMask?: (page: Page) => Locator[];
+};
+export type ExpectScreenshotFn = (params?: ExpectScreenshotOptions) => Promise<void>;
+export type ExpectScreenshotTestArgs = {
+    expectScreenshot: ExpectScreenshotFn;
+};

package/fixtures/expect-screenshot/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/fixtures/global-settings/global-settings-fixture.d.ts

@@ -0,0 +1,3 @@
+import type { Fixtures, PlaywrightTestArgs, PlaywrightTestOptions, PlaywrightWorkerArgs, PlaywrightWorkerOptions } from '@playwright/test';
+import type { GlobalSettingsFixturesBuilderParams, GlobalSettingsTestArgs, GlobalSettingsWorkerArgs } from './types';
+export declare function globalSettingsFixturesBuilder({ globalSettings }?: GlobalSettingsFixturesBuilderParams): Fixtures<GlobalSettingsTestArgs, GlobalSettingsWorkerArgs, PlaywrightTestArgs & PlaywrightTestOptions, PlaywrightWorkerArgs & PlaywrightWorkerOptions>;

package/fixtures/global-settings/global-settings-fixture.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalSettingsFixturesBuilder = globalSettingsFixturesBuilder;
+const actions_1 = require("../../actions");
+function globalSettingsFixturesBuilder({ globalSettings } = { globalSettings: {} }) {
+    const initGlobalSettingsFixture = async ({}, use) => {
+        (0, actions_1.setGlobalSettings)(globalSettings);
+        await use();
+    };
+    const setGlobalSettingsFixture = async ({}, use) => {
+        await use(actions_1.setGlobalSettings);
+    };
+    const getGlobalSettingsFixture = async ({}, use) => {
+        await use(actions_1.getGlobalSettings);
+    };
+    const fixtures = {
+        initGlobalSettings: [initGlobalSettingsFixture, { scope: 'worker', auto: true }],
+        setGlobalSettings: [setGlobalSettingsFixture, { scope: 'test' }],
+        getGlobalSettings: [getGlobalSettingsFixture, { scope: 'test' }],
+    };
+    return fixtures;
+}

package/fixtures/global-settings/index.d.ts

@@ -0,0 +1,2 @@
+export type { GlobalSettingsFixturesBuilderParams, GlobalSettingsTestArgs, GlobalSettingsWorkerArgs, } from './types';
+export { globalSettingsFixturesBuilder } from './global-settings-fixture';

package/fixtures/global-settings/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalSettingsFixturesBuilder = void 0;
+var global_settings_fixture_1 = require("./global-settings-fixture");
+Object.defineProperty(exports, "globalSettingsFixturesBuilder", { enumerable: true, get: function () { return global_settings_fixture_1.globalSettingsFixturesBuilder; } });

package/fixtures/global-settings/types.d.ts

@@ -0,0 +1,15 @@
+import type { getGlobalSettings, setGlobalSettings } from '../../actions';
+import type { PartialGlobalSettings } from '../../data/globalSettings';
+export type GlobalSettingsFixturesBuilderParams = {
+    /**
+     * Global settings that need to be overridden
+     */
+    globalSettings: PartialGlobalSettings;
+};
+export type GlobalSettingsWorkerArgs = {
+    initGlobalSettings: void;
+};
+export type GlobalSettingsTestArgs = {
+    setGlobalSettings: typeof setGlobalSettings;
+    getGlobalSettings: typeof getGlobalSettings;
+};

package/fixtures/global-settings/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/fixtures/index.d.ts

@@ -0,0 +1,10 @@
+export type { TestSlugResult } from './testSlug';
+export { testSlug } from './testSlug';
+export type { MockNetworkFixtureBuilderParams } from './mock-network';
+export { mockNetworkFixtureBuilder } from './mock-network';
+export type { ExpectRequestFn, ExpectRequestTestArgs, ExpectRequestFnMatcher, ExpectRequestFnOptions, } from './expect-request';
+export { expectRequest } from './expect-request';
+export type { ExpectScreenshotFn, ExpectScreenshotTestArgs, ExpectScreenshotFixtureBuilderParams, } from './expect-screenshot';
+export { expectScreenshotFixtureBuilder } from './expect-screenshot';
+export type { GlobalSettingsFixturesBuilderParams, GlobalSettingsTestArgs, GlobalSettingsWorkerArgs, } from './global-settings';
+export { globalSettingsFixturesBuilder } from './global-settings';

package/fixtures/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalSettingsFixturesBuilder = exports.expectScreenshotFixtureBuilder = exports.expectRequest = exports.mockNetworkFixtureBuilder = exports.testSlug = void 0;
+var testSlug_1 = require("./testSlug");
+Object.defineProperty(exports, "testSlug", { enumerable: true, get: function () { return testSlug_1.testSlug; } });
+var mock_network_1 = require("./mock-network");
+Object.defineProperty(exports, "mockNetworkFixtureBuilder", { enumerable: true, get: function () { return mock_network_1.mockNetworkFixtureBuilder; } });
+var expect_request_1 = require("./expect-request");
+Object.defineProperty(exports, "expectRequest", { enumerable: true, get: function () { return expect_request_1.expectRequest; } });
+var expect_screenshot_1 = require("./expect-screenshot");
+Object.defineProperty(exports, "expectScreenshotFixtureBuilder", { enumerable: true, get: function () { return expect_screenshot_1.expectScreenshotFixtureBuilder; } });
+var global_settings_1 = require("./global-settings");
+Object.defineProperty(exports, "globalSettingsFixturesBuilder", { enumerable: true, get: function () { return global_settings_1.globalSettingsFixturesBuilder; } });

package/fixtures/mock-network/har-patcher.d.ts

@@ -0,0 +1,8 @@
+import type { MockNetworkFixtureBuilderParams } from './types';
+export type HarPatcherParams = Pick<MockNetworkFixtureBuilderParams, 'headersToRemove' | 'setCookieToRemove' | 'onHarEntryWillRead' | 'onHarEntryWillWrite' | 'onTransformHarLookupParams' | 'onTransformHarLookupResult'> & {
+    /**
+     * Base url of the test
+     */
+    baseURL: string;
+};
+export declare function harPatcher({ baseURL, headersToRemove: additionalHeadersToRemove, setCookieToRemove: additionalSetCookieToRemove, onHarEntryWillWrite, onHarEntryWillRead, onTransformHarLookupParams, onTransformHarLookupResult, }: HarPatcherParams): void;

package/fixtures/mock-network/har-patcher.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.harPatcher = harPatcher;
+const har_1 = require("../../har");
+const DEFAULT_REMOVE_HEADERS = new Set([
+    'cookie',
+    'x-csrf-token',
+    'content-security-policy',
+    'Session_id',
+]);
+const DEFAULT_REMOVE_SET_COOKIE_FOR = new Set(['CSRF-TOKEN']);
+const baseUrlPLaceholder = 'https://base.url.placeholder';
+function harPatcher({ baseURL, headersToRemove: additionalHeadersToRemove = [], setCookieToRemove: additionalSetCookieToRemove = [], onHarEntryWillWrite, onHarEntryWillRead, onTransformHarLookupParams, onTransformHarLookupResult, }) {
+    const headersToRemove = new Set([...DEFAULT_REMOVE_HEADERS, ...additionalHeadersToRemove]);
+    const setCookieToRemove = new Set([
+        ...DEFAULT_REMOVE_SET_COOKIE_FOR,
+        ...additionalSetCookieToRemove,
+    ]);
+    (0, har_1.addHarRecorderTransform)((entry) => {
+        // eslint-disable-next-line no-param-reassign
+        entry.request.headers = (0, har_1.clearHeaders)(entry.request.headers, {
+            removeHeaders: headersToRemove,
+        });
+        // eslint-disable-next-line no-param-reassign
+        entry.response.headers = (0, har_1.clearHeaders)(entry.response.headers, {
+            removeHeaders: headersToRemove,
+            removeSetCookieFor: setCookieToRemove,
+        });
+        (0, har_1.replaceBaseUrlInEntry)(entry, baseURL, baseUrlPLaceholder);
+        onHarEntryWillWrite?.(entry);
+    });
+    (0, har_1.addHarOpenTransform)((harFile) => {
+        const entries = harFile.log.entries;
+        for (const entry of entries) {
+            (0, har_1.replaceBaseUrlInEntry)(entry, baseUrlPLaceholder, baseURL);
+            onHarEntryWillRead?.(entry);
+        }
+    });
+    (0, har_1.addHarLookupTransform)(onTransformHarLookupParams, onTransformHarLookupResult);
+}

package/fixtures/mock-network/index.d.ts

@@ -0,0 +1,2 @@
+export { mockNetworkFixtureBuilder } from './mock-network-fixture';
+export type { MockNetworkFixtureBuilderParams } from './types';

package/fixtures/mock-network/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockNetworkFixtureBuilder = void 0;
+var mock_network_fixture_1 = require("./mock-network-fixture");
+Object.defineProperty(exports, "mockNetworkFixtureBuilder", { enumerable: true, get: function () { return mock_network_fixture_1.mockNetworkFixtureBuilder; } });

package/fixtures/mock-network/mock-network-fixture.d.ts

@@ -0,0 +1,6 @@
+import type { PlaywrightTestArgs, PlaywrightTestOptions, TestFixture } from '@playwright/test';
+import type { MockNetworkFixtureBuilderParams } from './types';
+export declare function mockNetworkFixtureBuilder({ shouldUpdate, forceUpdateIfHarMissing, updateTimeout, zip, url: urlMatcherBuilder, dumpsPath, dumpsFilePath, ...harPatcherParams }: MockNetworkFixtureBuilderParams): [TestFixture<boolean, PlaywrightTestArgs & PlaywrightTestOptions>, {
+    auto: boolean;
+    scope: "test";
+}];

package/fixtures/mock-network/mock-network-fixture.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockNetworkFixtureBuilder = mockNetworkFixtureBuilder;
+const har_1 = require("../../har");
+const har_patcher_1 = require("./har-patcher");
+function mockNetworkFixtureBuilder({ shouldUpdate, forceUpdateIfHarMissing, updateTimeout, zip = true, url: urlMatcherBuilder, dumpsPath, dumpsFilePath, ...harPatcherParams }) {
+    const mockNetworkFixture = async ({ baseURL: rawBaseURL, page }, use, testInfo) => {
+        if (!rawBaseURL) {
+            throw new Error('baseURL should be specified in playwright config');
+        }
+        const baseURL = rawBaseURL.replace(/\/+$/, '');
+        (0, har_patcher_1.harPatcher)({
+            baseURL,
+            ...harPatcherParams,
+        });
+        const update = Boolean(shouldUpdate);
+        const url = urlMatcherBuilder(baseURL);
+        await (0, har_1.initDumps)(page, testInfo, {
+            dumpsPath,
+            dumpsFilePath,
+            forceUpdateIfHarMissing,
+            updateTimeout,
+            update,
+            url,
+            zip,
+        });
+        await use(!update);
+    };
+    const fixtureOptions = {
+        auto: true,
+        scope: 'test',
+    };
+    const mockNetwork = [
+        mockNetworkFixture,
+        fixtureOptions,
+    ];
+    return mockNetwork;
+}