@crawlee/browser-pool 3.0.0-alpha.9 → 3.0.0-beta.2

package/playwright/playwright-controller.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlaywrightController = void 0;
+const timeout_1 = require("@apify/timeout");
+const browser_controller_1 = require("../abstract-classes/browser-controller");
+const anonymize_proxy_1 = require("../anonymize-proxy");
+class PlaywrightController extends browser_controller_1.BrowserController {
+    normalizeProxyOptions(proxyUrl, pageOptions) {
+        if (!proxyUrl) {
+            return {};
+        }
+        const url = new URL(proxyUrl);
+        const username = decodeURIComponent(url.username);
+        const password = decodeURIComponent(url.password);
+        return {
+            proxy: {
+                server: url.origin,
+                username,
+                password,
+                bypass: pageOptions?.proxy?.bypass,
+            },
+        };
+    }
+    async _newPage(contextOptions) {
+        if (contextOptions !== undefined && !this.launchContext.useIncognitoPages) {
+            throw new Error('A new page can be created with provided context only when using incognito pages.');
+        }
+        // eslint-disable-next-line @typescript-eslint/no-empty-function
+        let close = async () => { };
+        if (contextOptions?.proxy) {
+            const [anonymizedProxyUrl, closeProxy] = await (0, anonymize_proxy_1.anonymizeProxySugar)(contextOptions.proxy.server, contextOptions.proxy.username, contextOptions.proxy.password);
+            if (anonymizedProxyUrl) {
+                contextOptions.proxy = {
+                    server: anonymizedProxyUrl,
+                    bypass: contextOptions.proxy.bypass,
+                };
+            }
+            close = closeProxy;
+        }
+        try {
+            const page = await this.browser.newPage(contextOptions);
+            (0, timeout_1.tryCancel)();
+            page.once('close', async () => {
+                this.activePages--;
+                await close();
+            });
+            return page;
+        }
+        catch (error) {
+            await close();
+            throw error;
+        }
+    }
+    async _close() {
+        await this.browser.close();
+    }
+    async _kill() {
+        // TODO: We need to be absolutely sure the browser dies.
+        await this.browser.close(); // Playwright does not have the browser child process attached to normal browser server
+    }
+    _getCookies(page) {
+        const context = page.context();
+        return context.cookies();
+    }
+    _setCookies(page, cookies) {
+        const context = page.context();
+        return context.addCookies(cookies);
+    }
+}
+exports.PlaywrightController = PlaywrightController;
+//# sourceMappingURL=playwright-controller.js.map

package/playwright/playwright-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-controller.js","sourceRoot":"","sources":["../../src/playwright/playwright-controller.ts"],"names":[],"mappings":";;;AACA,4CAA2C;AAC3C,+EAAmF;AACnF,wDAAyD;AAEzD,MAAa,oBAAqB,SAAQ,sCAA6E;IACnH,qBAAqB,CAAC,QAA4B,EAAE,WAAgB;QAChE,IAAI,CAAC,QAAQ,EAAE;YACX,OAAO,EAAE,CAAC;SACb;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAElD,OAAO;YACH,KAAK,EAAE;gBACH,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,QAAQ;gBACR,QAAQ;gBACR,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM;aACrC;SACJ,CAAC;IACN,CAAC;IAES,KAAK,CAAC,QAAQ,CAAC,cAAkD;QACvE,IAAI,cAAc,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE;YACvE,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;SACvG;QAED,gEAAgE;QAChE,IAAI,KAAK,GAAG,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;QAC3B,IAAI,cAAc,EAAE,KAAK,EAAE;YACvB,MAAM,CAAC,kBAAkB,EAAE,UAAU,CAAC,GAAG,MAAM,IAAA,qCAAmB,EAC9D,cAAc,CAAC,KAAK,CAAC,MAAM,EAC3B,cAAc,CAAC,KAAK,CAAC,QAAQ,EAC7B,cAAc,CAAC,KAAK,CAAC,QAAQ,CAChC,CAAC;YAEF,IAAI,kBAAkB,EAAE;gBACpB,cAAc,CAAC,KAAK,GAAG;oBACnB,MAAM,EAAE,kBAAkB;oBAC1B,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,MAAM;iBACtC,CAAC;aACL;YAED,KAAK,GAAG,UAAU,CAAC;SACtB;QAED,IAAI;YACA,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACxD,IAAA,mBAAS,GAAE,CAAC;YAEZ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;gBAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;gBAEnB,MAAM,KAAK,EAAE,CAAC;YAClB,CAAC,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC;SACf;QAAC,OAAO,KAAK,EAAE;YACZ,MAAM,KAAK,EAAE,CAAC;YAEd,MAAM,KAAK,CAAC;SACf;IACL,CAAC;IAES,KAAK,CAAC,MAAM;QAClB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAES,KAAK,CAAC,KAAK;QACjB,wDAAwD;QACxD,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,uFAAuF;IACvH,CAAC;IAES,WAAW,CAAC,IAAU;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAES,WAAW,CAAC,IAAU,EAAE,OAAiB;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;CACJ;AAhFD,oDAgFC"}

package/playwright/playwright-plugin.d.ts

@@ -0,0 +1,13 @@
+// @ts-ignore optional peer dependency
+import type { Browser as PlaywrightBrowser, BrowserType } from 'playwright';
+import { BrowserController } from '../abstract-classes/browser-controller';
+import { BrowserPlugin } from '../abstract-classes/browser-plugin';
+import { LaunchContext } from '../launch-context';
+export declare class PlaywrightPlugin extends BrowserPlugin<BrowserType, Parameters<BrowserType['launch']>[0], PlaywrightBrowser> {
+    private _browserVersion?;
+    protected _launch(launchContext: LaunchContext<BrowserType>): Promise<PlaywrightBrowser>;
+    protected _createController(): BrowserController<BrowserType, Parameters<BrowserType['launch']>[0], PlaywrightBrowser>;
+    protected _addProxyToLaunchOptions(launchContext: LaunchContext<BrowserType>): Promise<void>;
+    protected _isChromiumBasedBrowser(): boolean;
+}
+//# sourceMappingURL=playwright-plugin.d.ts.map

package/playwright/playwright-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-plugin.d.ts","sourceRoot":"","sources":["../../src/playwright/playwright-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKlD,qBAAa,gBAAiB,SAAQ,aAAa,CAAC,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC;IACrH,OAAO,CAAC,eAAe,CAAC,CAAS;cAEjB,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+D9F,SAAS,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC;cAItG,wBAAwB,CAAC,aAAa,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlG,SAAS,CAAC,uBAAuB,IAAI,OAAO;CAI/C"}

package/playwright/playwright-plugin.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlaywrightPlugin = void 0;
+const browser_1 = require("./browser");
+const playwright_controller_1 = require("./playwright-controller");
+const browser_plugin_1 = require("../abstract-classes/browser-plugin");
+const logger_1 = require("../logger");
+const proxy_server_1 = require("../proxy-server");
+const anonymize_proxy_1 = require("../anonymize-proxy");
+class PlaywrightPlugin extends browser_plugin_1.BrowserPlugin {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "_browserVersion", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+    }
+    async _launch(launchContext) {
+        const { launchOptions, useIncognitoPages, userDataDir, proxyUrl, } = launchContext;
+        let browser;
+        // Required for the `proxy` context option to work.
+        launchOptions.proxy = {
+            server: await (0, proxy_server_1.getLocalProxyAddress)(),
+            ...launchOptions.proxy,
+        };
+        const [anonymizedProxyUrl, close] = await (0, anonymize_proxy_1.anonymizeProxySugar)(proxyUrl);
+        if (anonymizedProxyUrl) {
+            launchOptions.proxy = {
+                server: anonymizedProxyUrl,
+                bypass: launchOptions.proxy.bypass,
+            };
+        }
+        try {
+            if (useIncognitoPages) {
+                browser = await this.library.launch(launchOptions);
+                if (anonymizedProxyUrl) {
+                    browser.on('disconnected', async () => {
+                        await close();
+                    });
+                }
+            }
+            else {
+                const browserContext = await this.library.launchPersistentContext(userDataDir, launchOptions);
+                if (anonymizedProxyUrl) {
+                    browserContext.on('close', async () => {
+                        await close();
+                    });
+                }
+                if (!this._browserVersion) {
+                    // Launches unused browser just to get the browser version.
+                    const inactiveBrowser = await this.library.launch(launchOptions);
+                    this._browserVersion = inactiveBrowser.version();
+                    inactiveBrowser.close().catch((error) => {
+                        logger_1.log.exception(error, 'Failed to close browser.');
+                    });
+                }
+                browser = new browser_1.Browser({ browserContext, version: this._browserVersion });
+            }
+        }
+        catch (error) {
+            await close();
+            throw error;
+        }
+        return browser;
+    }
+    _createController() {
+        return new playwright_controller_1.PlaywrightController(this);
+    }
+    async _addProxyToLaunchOptions(launchContext) {
+        launchContext.launchOptions ?? (launchContext.launchOptions = {});
+        const { launchOptions, proxyUrl } = launchContext;
+        if (proxyUrl) {
+            const url = new URL(proxyUrl);
+            launchOptions.proxy = {
+                server: url.origin,
+                username: decodeURIComponent(url.username),
+                password: decodeURIComponent(url.password),
+            };
+        }
+    }
+    _isChromiumBasedBrowser() {
+        const name = this.library.name();
+        return name === 'chromium';
+    }
+}
+exports.PlaywrightPlugin = PlaywrightPlugin;
+//# sourceMappingURL=playwright-plugin.js.map

package/playwright/playwright-plugin.js.map

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

package/proxy-server.d.ts

@@ -0,0 +1,2 @@
+export declare function getLocalProxyAddress(): Promise<string>;
+//# sourceMappingURL=proxy-server.d.ts.map

package/proxy-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-server.d.ts","sourceRoot":"","sources":["../src/proxy-server.ts"],"names":[],"mappings":"AAaA,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAI5D"}

package/proxy-server.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLocalProxyAddress = void 0;
+const proxy_chain_1 = require("proxy-chain");
+const server = new proxy_chain_1.Server({
+    port: 0,
+});
+server.server.unref();
+const listenPromise = server.listen();
+// eslint-disable-next-line @typescript-eslint/no-empty-function
+listenPromise.catch(() => { });
+// https://github.com/microsoft/playwright/blob/2e4722d460b5142267e0e506ca7ea9a259556b5f/packages/playwright-core/src/server/browserContext.ts#L423-L427
+async function getLocalProxyAddress() {
+    await listenPromise;
+    return `http://127.0.0.1:${server.port}`;
+}
+exports.getLocalProxyAddress = getLocalProxyAddress;
+//# sourceMappingURL=proxy-server.js.map

package/proxy-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-server.js","sourceRoot":"","sources":["../src/proxy-server.ts"],"names":[],"mappings":";;;AAAA,6CAAyD;AAEzD,MAAM,MAAM,GAAG,IAAI,oBAAgB,CAAC;IAChC,IAAI,EAAE,CAAC;CACV,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;AAEtB,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;AACtC,gEAAgE;AAChE,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAE9B,wJAAwJ;AACjJ,KAAK,UAAU,oBAAoB;IACtC,MAAM,aAAa,CAAC;IAEpB,OAAO,oBAAoB,MAAM,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC;AAJD,oDAIC"}

package/puppeteer/puppeteer-controller.d.ts

@@ -0,0 +1,11 @@
+import type Puppeteer from './puppeteer-proxy-per-page';
+import { BrowserController, Cookie } from '../abstract-classes/browser-controller';
+export declare class PuppeteerController extends BrowserController<typeof Puppeteer> {
+    normalizeProxyOptions(proxyUrl: string | undefined, pageOptions: any): Record<string, unknown>;
+    protected _newPage(contextOptions?: Puppeteer.ContextOptions): Promise<Puppeteer.Page>;
+    protected _close(): Promise<void>;
+    protected _kill(): Promise<void>;
+    protected _getCookies(page: Puppeteer.Page): Promise<Cookie[]>;
+    protected _setCookies(page: Puppeteer.Page, cookies: Cookie[]): Promise<void>;
+}
+//# sourceMappingURL=puppeteer-controller.d.ts.map

package/puppeteer/puppeteer-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer-controller.d.ts","sourceRoot":"","sources":["../../src/puppeteer/puppeteer-controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,wCAAwC,CAAC;AAMnF,qBAAa,mBAAoB,SAAQ,iBAAiB,CAAC,OAAO,SAAS,CAAC;IACxE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAiB9E,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;cAuE5E,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;cAIvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBtC,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI9D,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhF"}

package/puppeteer/puppeteer-controller.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PuppeteerController = void 0;
+const timeout_1 = require("@apify/timeout");
+const browser_controller_1 = require("../abstract-classes/browser-controller");
+const logger_1 = require("../logger");
+const anonymize_proxy_1 = require("../anonymize-proxy");
+const PROCESS_KILL_TIMEOUT_MILLIS = 5000;
+class PuppeteerController extends browser_controller_1.BrowserController {
+    normalizeProxyOptions(proxyUrl, pageOptions) {
+        if (!proxyUrl) {
+            return {};
+        }
+        const url = new URL(proxyUrl);
+        const username = decodeURIComponent(url.username);
+        const password = decodeURIComponent(url.password);
+        return {
+            proxyServer: url.origin,
+            proxyUsername: username,
+            proxyPassword: password,
+            proxyBypassList: pageOptions?.proxyBypassList,
+        };
+    }
+    async _newPage(contextOptions) {
+        if (contextOptions !== undefined) {
+            if (!this.launchContext.useIncognitoPages) {
+                throw new Error('A new page can be created with provided context only when using incognito pages.');
+            }
+            // eslint-disable-next-line @typescript-eslint/no-empty-function
+            let close = async () => { };
+            if (contextOptions.proxyServer) {
+                const [anonymizedProxyUrl, closeProxy] = await (0, anonymize_proxy_1.anonymizeProxySugar)(contextOptions.proxyServer, contextOptions.proxyUsername, contextOptions.proxyPassword);
+                if (anonymizedProxyUrl) {
+                    contextOptions.proxyServer = anonymizedProxyUrl;
+                    delete contextOptions.proxyUsername;
+                    delete contextOptions.proxyPassword;
+                }
+                close = closeProxy;
+            }
+            try {
+                const context = await this.browser.createIncognitoBrowserContext(contextOptions);
+                (0, timeout_1.tryCancel)();
+                const page = await context.newPage();
+                (0, timeout_1.tryCancel)();
+                /*
+                // DO NOT USE YET! DOING SO DISABLES CACHE WHICH IS 50% PERFORMANCE HIT!
+                if (contextOptions.proxyUsername || contextOptions.proxyPassword) {
+                    await page.authenticate({
+                        username: contextOptions.proxyUsername ?? '',
+                        password: contextOptions.proxyPassword ?? '',
+                    });
+                    tryCancel();
+                }
+                */
+                page.once('close', async () => {
+                    this.activePages--;
+                    try {
+                        await context.close();
+                    }
+                    catch (error) {
+                        logger_1.log.exception(error, 'Failed to close context.');
+                    }
+                    finally {
+                        await close();
+                    }
+                });
+                return page;
+            }
+            catch (error) {
+                await close();
+                throw error;
+            }
+        }
+        const page = await this.browser.newPage();
+        (0, timeout_1.tryCancel)();
+        page.once('close', () => {
+            this.activePages--;
+        });
+        return page;
+    }
+    async _close() {
+        await this.browser.close();
+    }
+    async _kill() {
+        const browserProcess = this.browser.process();
+        if (!browserProcess) {
+            // TODO: LOG browser was connected using the `puppeteer.connect` method no browser to kill.
+            return;
+        }
+        const timeout = setTimeout(() => {
+            // This is here because users reported that it happened
+            // that error `TypeError: Cannot read property 'kill' of null` was thrown.
+            // Likely Chrome process wasn't started due to some error ...
+            browserProcess?.kill('SIGKILL');
+        }, PROCESS_KILL_TIMEOUT_MILLIS);
+        try {
+            await this.browser.close();
+            clearTimeout(timeout);
+        }
+        catch (e) {
+            // TODO: LOG Browser was already killed.
+        }
+    }
+    _getCookies(page) {
+        return page.cookies();
+    }
+    _setCookies(page, cookies) {
+        return page.setCookie(...cookies);
+    }
+}
+exports.PuppeteerController = PuppeteerController;
+//# sourceMappingURL=puppeteer-controller.js.map

package/puppeteer/puppeteer-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer-controller.js","sourceRoot":"","sources":["../../src/puppeteer/puppeteer-controller.ts"],"names":[],"mappings":";;;AAAA,4CAA2C;AAE3C,+EAAmF;AACnF,sCAAgC;AAChC,wDAAyD;AAEzD,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEzC,MAAa,mBAAoB,SAAQ,sCAAmC;IACxE,qBAAqB,CAAC,QAA4B,EAAE,WAAgB;QAChE,IAAI,CAAC,QAAQ,EAAE;YACX,OAAO,EAAE,CAAC;SACb;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAElD,OAAO;YACH,WAAW,EAAE,GAAG,CAAC,MAAM;YACvB,aAAa,EAAE,QAAQ;YACvB,aAAa,EAAE,QAAQ;YACvB,eAAe,EAAE,WAAW,EAAE,eAAe;SAChD,CAAC;IACN,CAAC;IAES,KAAK,CAAC,QAAQ,CAAC,cAAyC;QAC9D,IAAI,cAAc,KAAK,SAAS,EAAE;YAC9B,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE;gBACvC,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;aACvG;YAED,gEAAgE;YAChE,IAAI,KAAK,GAAG,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;YAC3B,IAAI,cAAc,CAAC,WAAW,EAAE;gBAC5B,MAAM,CAAC,kBAAkB,EAAE,UAAU,CAAC,GAAG,MAAM,IAAA,qCAAmB,EAC9D,cAAc,CAAC,WAAW,EAC1B,cAAc,CAAC,aAAa,EAC5B,cAAc,CAAC,aAAa,CAC/B,CAAC;gBAEF,IAAI,kBAAkB,EAAE;oBACpB,cAAc,CAAC,WAAW,GAAG,kBAAkB,CAAC;oBAChD,OAAO,cAAc,CAAC,aAAa,CAAC;oBACpC,OAAO,cAAc,CAAC,aAAa,CAAC;iBACvC;gBAED,KAAK,GAAG,UAAU,CAAC;aACtB;YAED,IAAI;gBACA,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,cAAc,CAAC,CAAC;gBACjF,IAAA,mBAAS,GAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;gBACrC,IAAA,mBAAS,GAAE,CAAC;gBAEZ;;;;;;;;;kBASE;gBAEF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;oBAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;oBAEnB,IAAI;wBACA,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;qBACzB;oBAAC,OAAO,KAAU,EAAE;wBACjB,YAAG,CAAC,SAAS,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;qBACpD;4BAAS;wBACN,MAAM,KAAK,EAAE,CAAC;qBACjB;gBACL,CAAC,CAAC,CAAC;gBAEH,OAAO,IAAI,CAAC;aACf;YAAC,OAAO,KAAK,EAAE;gBACZ,MAAM,KAAK,EAAE,CAAC;gBAEd,MAAM,KAAK,CAAC;aACf;SACJ;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAA,mBAAS,GAAE,CAAC;QAEZ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACpB,IAAI,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IAChB,CAAC;IAES,KAAK,CAAC,MAAM;QAClB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAES,KAAK,CAAC,KAAK;QACjB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAE9C,IAAI,CAAC,cAAc,EAAE;YACjB,2FAA2F;YAC3F,OAAO;SACV;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,uDAAuD;YACvD,0EAA0E;YAC1E,6DAA6D;YAC7D,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC,EAAE,2BAA2B,CAAC,CAAC;QAEhC,IAAI;YACA,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC3B,YAAY,CAAC,OAAO,CAAC,CAAC;SACzB;QAAC,OAAO,CAAC,EAAE;YACR,wCAAwC;SAC3C;IACL,CAAC;IAES,WAAW,CAAC,IAAoB;QACtC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAES,WAAW,CAAC,IAAoB,EAAE,OAAiB;QACzD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC;IACtC,CAAC;CACJ;AA3HD,kDA2HC"}

package/puppeteer/puppeteer-plugin.d.ts

@@ -0,0 +1,12 @@
+import type Puppeteer from './puppeteer-proxy-per-page';
+import type { Browser } from './puppeteer-proxy-per-page';
+import { BrowserController } from '../abstract-classes/browser-controller';
+import { BrowserPlugin } from '../abstract-classes/browser-plugin';
+import { LaunchContext } from '../launch-context';
+export declare class PuppeteerPlugin extends BrowserPlugin<typeof Puppeteer> {
+    protected _launch(launchContext: LaunchContext<typeof Puppeteer>): Promise<Browser>;
+    protected _createController(): BrowserController<typeof Puppeteer>;
+    protected _addProxyToLaunchOptions(launchContext: LaunchContext<typeof Puppeteer>): Promise<void>;
+    protected _isChromiumBasedBrowser(launchContext: LaunchContext<typeof Puppeteer>): boolean;
+}
+//# sourceMappingURL=puppeteer-plugin.d.ts.map

package/puppeteer/puppeteer-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer-plugin.d.ts","sourceRoot":"","sources":["../../src/puppeteer/puppeteer-plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAA0B,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQlD,qBAAa,eAAgB,SAAQ,aAAa,CAAC,OAAO,SAAS,CAAC;cAChD,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC,OAAO,SAAS,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IA2HzF,SAAS,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,OAAO,SAAS,CAAC;cAIlD,wBAAwB,CACpC,aAAa,EAAE,aAAa,CAAC,OAAO,SAAS,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC;IA8BhB,SAAS,CAAC,uBAAuB,CAAC,aAAa,EAAE,aAAa,CAAC,OAAO,SAAS,CAAC,GAAG,OAAO;CAM7F"}

package/puppeteer/puppeteer-plugin.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PuppeteerPlugin = void 0;
+const browser_plugin_1 = require("../abstract-classes/browser-plugin");
+const logger_1 = require("../logger");
+const utils_1 = require("../utils");
+const puppeteer_controller_1 = require("./puppeteer-controller");
+const anonymize_proxy_1 = require("../anonymize-proxy");
+const PROXY_SERVER_ARG = '--proxy-server=';
+class PuppeteerPlugin extends browser_plugin_1.BrowserPlugin {
+    async _launch(launchContext) {
+        const { launchOptions, userDataDir, useIncognitoPages, proxyUrl, } = launchContext;
+        launchOptions.userDataDir = launchOptions.userDataDir ?? userDataDir;
+        if (launchOptions.headless === false) {
+            if (Array.isArray(launchOptions.args)) {
+                launchOptions.args.push('--disable-site-isolation-trials');
+            }
+            else {
+                launchOptions.args = ['--disable-site-isolation-trials'];
+            }
+        }
+        let browser;
+        {
+            const [anonymizedProxyUrl, close] = await (0, anonymize_proxy_1.anonymizeProxySugar)(proxyUrl);
+            if (proxyUrl) {
+                const proxyArg = `${PROXY_SERVER_ARG}${anonymizedProxyUrl ?? proxyUrl}`;
+                if (Array.isArray(launchOptions.args)) {
+                    launchOptions.args.push(proxyArg);
+                }
+                else {
+                    launchOptions.args = [proxyArg];
+                }
+            }
+            try {
+                browser = await this.library.launch(launchOptions);
+                if (anonymizedProxyUrl) {
+                    browser.on('disconnected', async () => {
+                        await close();
+                    });
+                }
+            }
+            catch (error) {
+                await close();
+                throw error;
+            }
+        }
+        browser.on('targetcreated', async (target) => {
+            try {
+                const page = await target.page();
+                if (page) {
+                    page.on('error', (error) => {
+                        logger_1.log.exception(error, 'Page crashed.');
+                        page.close().catch(utils_1.noop);
+                    });
+                }
+            }
+            catch (error) {
+                logger_1.log.exception(error, 'Failed to retrieve page from target.');
+            }
+        });
+        const newPage = browser.newPage.bind(browser);
+        browser = new Proxy(browser, {
+            get: (target, property) => {
+                if (property === 'newPage') {
+                    return (async (...args) => {
+                        let page;
+                        if (useIncognitoPages) {
+                            const [anonymizedProxyUrl, close] = await (0, anonymize_proxy_1.anonymizeProxySugar)(proxyUrl);
+                            try {
+                                const context = await browser.createIncognitoBrowserContext({
+                                    proxyServer: anonymizedProxyUrl ?? proxyUrl,
+                                });
+                                page = await context.newPage(...args);
+                                if (anonymizedProxyUrl) {
+                                    page.on('close', async () => {
+                                        await close();
+                                    });
+                                }
+                            }
+                            catch (error) {
+                                await close();
+                                throw error;
+                            }
+                        }
+                        else {
+                            page = await newPage(...args);
+                        }
+                        /*
+                        // DO NOT USE YET! DOING SO DISABLES CACHE WHICH IS 50% PERFORMANCE HIT!
+                        if (useIncognitoPages) {
+                            const context = await browser.createIncognitoBrowserContext({
+                                proxyServer: proxyUrl,
+                            });
+
+                            page = await context.newPage(...args);
+                        } else {
+                            page = await newPage(...args);
+                        }
+
+                        if (proxyCredentials) {
+                            await page.authenticate(proxyCredentials as Credentials);
+                        }
+                        */
+                        return page;
+                    });
+                }
+                return target[property];
+            },
+        });
+        return browser;
+    }
+    _createController() {
+        return new puppeteer_controller_1.PuppeteerController(this);
+    }
+    async _addProxyToLaunchOptions(launchContext) {
+        launchContext;
+        /*
+        // DO NOT USE YET! DOING SO DISABLES CACHE WHICH IS 50% PERFORMANCE HIT!
+        launchContext.launchOptions ??= {};
+
+        const { launchOptions, proxyUrl } = launchContext;
+
+        if (proxyUrl) {
+            const url = new URL(proxyUrl);
+
+            if (url.username || url.password) {
+                launchContext.proxyCredentials = {
+                    username: decodeURIComponent(url.username),
+                    password: decodeURIComponent(url.password),
+                };
+            }
+
+            const proxyArg = `${PROXY_SERVER_ARG}${url.origin}`;
+
+            if (Array.isArray(launchOptions.args)) {
+                launchOptions.args.push(proxyArg);
+            } else {
+                launchOptions.args = [proxyArg];
+            }
+        }
+        */
+    }
+    _isChromiumBasedBrowser(launchContext) {
+        const { launchOptions } = launchContext;
+        // @ts-expect-error cannot find .product on this.library
+        const browserName = launchOptions.product || this.library.product;
+        return browserName === 'chrome';
+    }
+}
+exports.PuppeteerPlugin = PuppeteerPlugin;
+//# sourceMappingURL=puppeteer-plugin.js.map

package/puppeteer/puppeteer-plugin.js.map

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

package/puppeteer/puppeteer-proxy-per-page.d.ts

@@ -0,0 +1,27 @@
+import type {
+    BrowserContextOptions,
+    Browser as PuppeteerBrowser,
+    Page,
+    LaunchOptions,
+    BrowserLaunchArgumentOptions,
+    BrowserConnectOptions,
+    Product,
+// @ts-ignore optional peer dependency
+} from 'puppeteer';
+
+// @ts-ignore optional peer dependency
+export * from 'puppeteer';
+
+export interface ContextOptions extends BrowserContextOptions {
+    proxyUsername?: string;
+    proxyPassword?: string;
+}
+
+export declare class Browser extends PuppeteerBrowser {
+    newPage: (contextOptions?: ContextOptions) => Promise<Page>;
+}
+
+export declare function launch(options?: LaunchOptions & BrowserLaunchArgumentOptions & BrowserConnectOptions & {
+    product?: Product;
+    extraPrefsFirefox?: Record<string, unknown>;
+}): Promise<Browser>;