@crawlee/browser-pool 4.0.0-beta.20 → 4.0.0-beta.201

package/events.d.ts

@@ -1,11 +1,9 @@
-export declare const enum BROWSER_POOL_EVENTS {
+export declare enum BROWSER_POOL_EVENTS {
     BROWSER_LAUNCHED = "browserLaunched",
     BROWSER_RETIRED = "browserRetired",
-    BROWSER_CLOSED = "browserClosed",
     PAGE_CREATED = "pageCreated",
     PAGE_CLOSED = "pageClosed"
 }
-export declare const enum BROWSER_CONTROLLER_EVENTS {
+export declare enum BROWSER_CONTROLLER_EVENTS {
     BROWSER_CLOSED = "browserClosed"
 }
-//# sourceMappingURL=events.d.ts.map

package/events.js

@@ -2,7 +2,6 @@ export var BROWSER_POOL_EVENTS;
 (function (BROWSER_POOL_EVENTS) {
     BROWSER_POOL_EVENTS["BROWSER_LAUNCHED"] = "browserLaunched";
     BROWSER_POOL_EVENTS["BROWSER_RETIRED"] = "browserRetired";
-    BROWSER_POOL_EVENTS["BROWSER_CLOSED"] = "browserClosed";
     BROWSER_POOL_EVENTS["PAGE_CREATED"] = "pageCreated";
     BROWSER_POOL_EVENTS["PAGE_CLOSED"] = "pageClosed";
 })(BROWSER_POOL_EVENTS || (BROWSER_POOL_EVENTS = {}));
@@ -10,4 +9,3 @@ export var BROWSER_CONTROLLER_EVENTS;
 (function (BROWSER_CONTROLLER_EVENTS) {
     BROWSER_CONTROLLER_EVENTS["BROWSER_CLOSED"] = "browserClosed";
 })(BROWSER_CONTROLLER_EVENTS || (BROWSER_CONTROLLER_EVENTS = {}));
-//# sourceMappingURL=events.js.map

package/fingerprinting/hooks.d.ts

@@ -14,4 +14,3 @@ export declare function createPrePageCreateHook(): (_pageId: string, browserCont
  * @internal
  */
 export declare function createPostPageCreateHook(fingerprintInjector: FingerprintInjector): (page: any, browserController: BrowserController) => Promise<void>;
-//# sourceMappingURL=hooks.d.ts.map

package/fingerprinting/hooks.js

@@ -1,29 +1,42 @@
 import { PlaywrightPlugin } from '../playwright/playwright-plugin.js';
 import { PuppeteerPlugin } from '../puppeteer/puppeteer-plugin.js';
 import { getGeneratorDefaultOptions } from './utils.js';
+function applySessionHints(base, fingerprint) {
+    if (!fingerprint)
+        return base;
+    return {
+        ...base,
+        ...(fingerprint.browser ? { browsers: [{ name: fingerprint.browser }] } : {}),
+        ...(fingerprint.platform ? { operatingSystems: [fingerprint.platform] } : {}),
+        ...(fingerprint.device ? { devices: [fingerprint.device] } : {}),
+    };
+}
 /**
  * @internal
  */
 export function createFingerprintPreLaunchHook(browserPool) {
     const { fingerprintGenerator, fingerprintCache, fingerprintOptions: { fingerprintGeneratorOptions }, } = browserPool;
     return (_pageId, launchContext) => {
+        // Remote browsers may have their own fingerprinting — skip local fingerprint injection
+        if (launchContext.isRemote)
+            return;
         const { useIncognitoPages } = launchContext;
-        const cacheKey = launchContext.session?.id ?? launchContext.proxyUrl;
+        const session = launchContext.session;
+        const cacheKey = session?.id ?? launchContext.proxyUrl;
         const { launchOptions } = launchContext;
-        // If no options are passed we try to pass best default options as possible to match browser and OS.
-        const fingerprintGeneratorFinalOptions = fingerprintGeneratorOptions || getGeneratorDefaultOptions(launchContext);
         let fingerprint;
         if (cacheKey && fingerprintCache?.has(cacheKey)) {
             fingerprint = fingerprintCache.get(cacheKey);
         }
-        else if (cacheKey) {
-            fingerprint = fingerprintGenerator.getFingerprint(fingerprintGeneratorFinalOptions);
-            fingerprintCache?.set(cacheKey, fingerprint);
-        }
         else {
-            fingerprint = fingerprintGenerator.getFingerprint(fingerprintGeneratorFinalOptions);
+            const baseOptions = fingerprintGeneratorOptions || getGeneratorDefaultOptions(launchContext);
+            const finalOptions = applySessionHints(baseOptions, session?.fingerprint);
+            fingerprint = fingerprintGenerator.getFingerprint(finalOptions);
+            if (cacheKey)
+                fingerprintCache?.set(cacheKey, fingerprint);
         }
-        launchContext.extend({ fingerprint });
+        // `fingerprint` is a declared field, so it cannot go through `extend()` (which rejects reserved names)
+        launchContext.fingerprint = fingerprint;
         if (useIncognitoPages) {
             return;
         }
@@ -41,6 +54,8 @@ export function createFingerprintPreLaunchHook(browserPool) {
 export function createPrePageCreateHook() {
     return (_pageId, browserController, pageOptions) => {
         const { launchContext, browserPlugin } = browserController;
+        if (launchContext.isRemote)
+            return;
         const { fingerprint } = launchContext.fingerprint;
         if (launchContext.useIncognitoPages && browserPlugin instanceof PlaywrightPlugin && pageOptions) {
             pageOptions.userAgent ??= fingerprint.navigator.userAgent;
@@ -57,6 +72,8 @@ export function createPrePageCreateHook() {
 export function createPostPageCreateHook(fingerprintInjector) {
     return async (page, browserController) => {
         const { browserPlugin, launchContext } = browserController;
+        if (launchContext.isRemote)
+            return;
         const fingerprint = launchContext.fingerprint;
         // TODO this will require refactoring, we should use common API instead of branching based on plugin type,
         //  and there should be no public methods specific to some browser.
@@ -79,4 +96,3 @@ export function createPostPageCreateHook(fingerprintInjector) {
         }
     };
 }
-//# sourceMappingURL=hooks.js.map

package/fingerprinting/types.d.ts

@@ -1,42 +1,13 @@
-import type { BrowserFingerprintWithHeaders as Fingerprint, FingerprintGeneratorOptions as FingerprintOptionsOriginal } from 'fingerprint-generator';
-export interface FingerprintGenerator {
-    getFingerprint: (fingerprintGeneratorOptions?: FingerprintGeneratorOptions) => GetFingerprintReturn;
-}
-export interface GetFingerprintReturn {
-    fingerprint: Fingerprint;
-}
+import type { FingerprintGeneratorOptions as FingerprintOptionsOriginal } from 'fingerprint-generator';
 export interface FingerprintGeneratorOptions extends Partial<FingerprintOptionsOriginal> {
 }
-declare const SUPPORTED_HTTP_VERSIONS: readonly ["1", "2"];
-/**
- * String specifying the HTTP version to use.
- */
-type HttpVersion = (typeof SUPPORTED_HTTP_VERSIONS)[number];
 export declare enum BrowserName {
     chrome = "chrome",
     firefox = "firefox",
     safari = "safari",
     edge = "edge"
 }
-export interface BrowserSpecification {
-    /**
-     * String representing the browser name.
-     */
-    name: BrowserName;
-    /**
-     * Minimum version of browser used.
-     */
-    minVersion?: number;
-    /**
-     * Maximum version of browser used.
-     */
-    maxVersion?: number;
-    /**
-     * HTTP version to be used for header generation (the headers differ depending on the version).
-     */
-    httpVersion?: HttpVersion;
-}
-export declare const enum OperatingSystemsName {
+export declare enum OperatingSystemsName {
     linux = "linux",
     macos = "macos",
     windows = "windows",
@@ -49,7 +20,7 @@ export declare const enum OperatingSystemsName {
      */
     ios = "ios"
 }
-export declare const enum DeviceCategory {
+export declare enum DeviceCategory {
     /**
      * Describes mobile devices (mobile phones, tablets...). These devices usually have smaller, vertical screens and load lighter versions of websites.
      * > Note: Generating `android` and `ios` devices will not work without setting the device to `mobile` first.
@@ -60,5 +31,3 @@ export declare const enum DeviceCategory {
      */
     desktop = "desktop"
 }
-export {};
-//# sourceMappingURL=types.d.ts.map

package/fingerprinting/types.js

@@ -1,4 +1,3 @@
-const SUPPORTED_HTTP_VERSIONS = ['1', '2'];
 export var BrowserName;
 (function (BrowserName) {
     BrowserName["chrome"] = "chrome";
@@ -32,4 +31,3 @@ export var DeviceCategory;
      */
     DeviceCategory["desktop"] = "desktop";
 })(DeviceCategory || (DeviceCategory = {}));
-//# sourceMappingURL=types.js.map

package/fingerprinting/utils.d.ts

@@ -1,4 +1,3 @@
 import type { LaunchContext } from '../launch-context.js';
 import type { FingerprintGeneratorOptions } from './types.js';
 export declare const getGeneratorDefaultOptions: (launchContext: LaunchContext) => FingerprintGeneratorOptions;
-//# sourceMappingURL=utils.d.ts.map

package/fingerprinting/utils.js

@@ -1,10 +1,10 @@
 import { PlaywrightPlugin } from '../playwright/playwright-plugin.js';
 import { PuppeteerPlugin } from '../puppeteer/puppeteer-plugin.js';
-import { BrowserName } from './types.js';
+import { BrowserName, DeviceCategory, OperatingSystemsName } from './types.js';
 export const getGeneratorDefaultOptions = (launchContext) => {
     const { browserPlugin, launchOptions } = launchContext;
     const options = {
-        devices: ["desktop" /* DeviceCategory.desktop */],
+        devices: [DeviceCategory.desktop],
         locales: ['en-US'],
         browsers: [getBrowserName(browserPlugin, launchOptions)],
         operatingSystems: [getOperatingSystem()],
@@ -34,12 +34,11 @@ const getOperatingSystem = () => {
     switch (platform) {
         case 'win32':
             // platform is win32 even for 64-bit
-            return "windows" /* OperatingSystemsName.windows */;
+            return OperatingSystemsName.windows;
         case 'darwin':
-            return "macos" /* OperatingSystemsName.macos */;
+            return OperatingSystemsName.macos;
         default:
             // consider everything else a linux
-            return "linux" /* OperatingSystemsName.linux */;
+            return OperatingSystemsName.linux;
     }
 };
-//# sourceMappingURL=utils.js.map

package/index.d.ts

@@ -28,13 +28,20 @@ export * from './browser-pool.js';
 export * from './playwright/playwright-plugin.js';
 export * from './puppeteer/puppeteer-plugin.js';
 export * from './events.js';
-export { BrowserName, DeviceCategory, OperatingSystemsName, } from './fingerprinting/types.js';
-export { BrowserController, BrowserControllerEvents } from './abstract-classes/browser-controller.js';
+export type { FingerprintGeneratorOptions } from './fingerprinting/types.js';
+export { BrowserName, DeviceCategory, OperatingSystemsName } from './fingerprinting/types.js';
+export type { BrowserControllerEvents, IBrowserController, IBrowserLaunchContext, } from './abstract-classes/browser-controller.js';
+export { BrowserController } from './abstract-classes/browser-controller.js';
 export { PuppeteerController } from './puppeteer/puppeteer-controller.js';
 export { PlaywrightController } from './playwright/playwright-controller.js';
 export { PlaywrightBrowser } from './playwright/playwright-browser.js';
-export { CommonPage, CommonLibrary, BrowserPlugin, BrowserPluginOptions, CreateLaunchContextOptions, BrowserLaunchError, DEFAULT_USER_AGENT, } from './abstract-classes/browser-plugin.js';
-export { LaunchContext, LaunchContextOptions } from './launch-context.js';
-export { BrowserSpecification, FingerprintGenerator, FingerprintGeneratorOptions, GetFingerprintReturn, } from './fingerprinting/types.js';
-export { InferBrowserPluginArray, UnwrapPromise } from './utils.js';
-//# sourceMappingURL=index.d.ts.map
+export type { CommonPage, CommonLibrary, BrowserPluginOptions, CreateLaunchContextOptions, } from './abstract-classes/browser-plugin.js';
+export { BrowserPlugin, BrowserLaunchError, DEFAULT_USER_AGENT } from './abstract-classes/browser-plugin.js';
+export type { LaunchContextOptions } from './launch-context.js';
+export { LaunchContext } from './launch-context.js';
+export { RemoteBrowserProvider } from './remote-browser-provider.js';
+export { RemoteBrowserPool } from './remote-browser-pool.js';
+export type { RemoteBrowserPoolOptions, CrawlerRemoteBrowserOptions, RemoteBrowserEndpoint, ResolvedRemoteEndpoint, RemoteConnection, RemoteConnectionParameters, } from './remote-browser-pool.js';
+export type { InferBrowserPluginArray, UnwrapPromise } from './utils.js';
+export { anonymizeProxySugar, type AnonymizeProxySugarOptions } from './anonymize-proxy.js';
+export type { IBrowserPool, NewPageOptions } from '@crawlee/types';

package/index.js

@@ -26,11 +26,13 @@ export * from './browser-pool.js';
 export * from './playwright/playwright-plugin.js';
 export * from './puppeteer/puppeteer-plugin.js';
 export * from './events.js';
-export { BrowserName, DeviceCategory, OperatingSystemsName, } from './fingerprinting/types.js';
+export { BrowserName, DeviceCategory, OperatingSystemsName } from './fingerprinting/types.js';
 export { BrowserController } from './abstract-classes/browser-controller.js';
 export { PuppeteerController } from './puppeteer/puppeteer-controller.js';
 export { PlaywrightController } from './playwright/playwright-controller.js';
 export { PlaywrightBrowser } from './playwright/playwright-browser.js';
-export { BrowserPlugin, BrowserLaunchError, DEFAULT_USER_AGENT, } from './abstract-classes/browser-plugin.js';
+export { BrowserPlugin, BrowserLaunchError, DEFAULT_USER_AGENT } from './abstract-classes/browser-plugin.js';
 export { LaunchContext } from './launch-context.js';
-//# sourceMappingURL=index.js.map
+export { RemoteBrowserProvider } from './remote-browser-provider.js';
+export { RemoteBrowserPool } from './remote-browser-pool.js';
+export { anonymizeProxySugar } from './anonymize-proxy.js';

package/launch-context.d.ts

@@ -43,19 +43,36 @@ export interface LaunchContextOptions<Library extends CommonLibrary = CommonLibr
      */
     userDataDir?: string;
     proxyUrl?: string;
-    proxyTier?: number;
+    /**
+     * If set to `true`, TLS certificate errors from the upstream proxy will be ignored.
+     * This is useful when using HTTPS proxies with self-signed certificates.
+     */
+    ignoreProxyCertificate?: boolean;
+    /**
+     * Whether this launch context represents a connection to a remote browser
+     * rather than a locally launched one.
+     * @default false
+     * @internal
+     */
+    isRemote?: boolean;
 }
 export declare class LaunchContext<Library extends CommonLibrary = CommonLibrary, LibraryOptions extends Dictionary | undefined = Parameters<Library['launch']>[0], LaunchResult extends CommonBrowser = UnwrapPromise<ReturnType<Library['launch']>>, NewPageOptions = Parameters<LaunchResult['newPage']>[0], NewPageResult = UnwrapPromise<ReturnType<LaunchResult['newPage']>>> {
+    #private;
     id?: string;
     browserPlugin: BrowserPlugin<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>;
     launchOptions: LibraryOptions;
     useIncognitoPages: boolean;
     browserPerProxy?: boolean;
     userDataDir: string;
-    proxyTier?: number;
-    private _proxyUrl?;
-    private readonly _reservedFieldNames;
+    readonly isRemote: boolean;
+    ignoreProxyCertificate?: boolean;
     fingerprint?: BrowserFingerprintWithHeaders;
+    /**
+     * Token identifying the remote browser session this context connected to, set by the plugin and read by
+     * the {@link RemoteBrowserPool} to release the session on close. Only present for remote connections.
+     * @internal
+     */
+    remoteToken?: number;
     [K: PropertyKey]: unknown;
     constructor(options: LaunchContextOptions<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>);
     /**
@@ -76,4 +93,3 @@ export declare class LaunchContext<Library extends CommonLibrary = CommonLibrary
      */
     get proxyUrl(): string | undefined;
 }
-//# sourceMappingURL=launch-context.d.ts.map

package/launch-context.js

@@ -5,20 +5,31 @@ export class LaunchContext {
     useIncognitoPages;
     browserPerProxy;
     userDataDir;
-    proxyTier;
-    _proxyUrl;
-    _reservedFieldNames = [...Reflect.ownKeys(this), 'extend'];
+    isRemote;
+    ignoreProxyCertificate;
+    #proxyUrl;
+    #reservedFieldNames;
     fingerprint;
+    /**
+     * Token identifying the remote browser session this context connected to, set by the plugin and read by
+     * the {@link RemoteBrowserPool} to release the session on close. Only present for remote connections.
+     * @internal
+     */
+    remoteToken;
     constructor(options) {
-        const { id, browserPlugin, launchOptions, proxyUrl, useIncognitoPages, browserPerProxy, userDataDir = '', proxyTier, } = options;
+        const { id, browserPlugin, launchOptions, proxyUrl, useIncognitoPages, browserPerProxy, userDataDir = '', ignoreProxyCertificate, isRemote, } = options;
         this.id = id;
         this.browserPlugin = browserPlugin;
         this.launchOptions = launchOptions;
         this.browserPerProxy = browserPerProxy ?? false;
         this.useIncognitoPages = useIncognitoPages ?? false;
         this.userDataDir = userDataDir;
-        this.proxyTier = proxyTier;
-        this._proxyUrl = proxyUrl;
+        this.ignoreProxyCertificate = ignoreProxyCertificate ?? false;
+        this.isRemote = isRemote ?? false;
+        this.#proxyUrl = proxyUrl;
+        // Computed here (not in a field initializer) so that all fields already exist; the accessors live on
+        // the prototype, so they are never own keys and have to be listed explicitly.
+        this.#reservedFieldNames = [...Reflect.ownKeys(this), 'proxyUrl', 'remoteToken', 'extend'];
     }
     /**
      * Extend the launch context with any extra fields.
@@ -29,7 +40,7 @@ export class LaunchContext {
      */
     extend(fields) {
         Object.entries(fields).forEach(([key, value]) => {
-            if (this._reservedFieldNames.includes(key)) {
+            if (this.#reservedFieldNames.includes(key)) {
                 throw new Error(`Cannot extend LaunchContext with key: ${key}, because it's reserved.`);
             }
             else {
@@ -43,6 +54,7 @@ export class LaunchContext {
      */
     set proxyUrl(url) {
         if (!url) {
+            this.#proxyUrl = undefined;
             return;
         }
         const urlInstance = new URL(url);
@@ -50,13 +62,12 @@ export class LaunchContext {
         urlInstance.search = '';
         urlInstance.hash = '';
         // https://www.chromium.org/developers/design-documents/network-settings/#command-line-options-for-proxy-settings
-        this._proxyUrl = urlInstance.href.slice(0, -1);
+        this.#proxyUrl = urlInstance.href.slice(0, -1);
     }
     /**
      * Returns the proxy URL of the browser.
      */
     get proxyUrl() {
-        return this._proxyUrl;
+        return this.#proxyUrl;
     }
 }
-//# sourceMappingURL=launch-context.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@crawlee/browser-pool",
-    "version": "4.0.0-beta.20",
+    "version": "4.0.0-beta.201",
     "description": "Rotate multiple browsers using popular automation libraries such as Playwright or Puppeteer.",
     "engines": {
         "node": ">=22.0.0"
@@ -24,26 +24,26 @@
         "url": "https://github.com/apify/crawlee/issues"
     },
     "scripts": {
-        "build": "yarn clean && yarn compile && yarn copy",
+        "build": "pnpm clean && pnpm compile && pnpm copy",
         "clean": "rimraf ./dist",
         "compile": "tsc -p tsconfig.build.json",
         "copy": "tsx ../../scripts/copy.ts"
     },
     "dependencies": {
-        "@apify/log": "^2.5.18",
-        "@apify/timeout": "^0.3.2",
-        "@crawlee/core": "4.0.0-beta.20",
-        "@crawlee/types": "4.0.0-beta.20",
+        "@apify/timeout": "^1.0.1",
+        "@crawlee/core": "4.0.0-beta.201",
+        "@crawlee/types": "4.0.0-beta.201",
+        "@crawlee/utils": "4.0.0-beta.201",
         "fingerprint-generator": "^2.1.68",
         "fingerprint-injector": "^2.1.68",
         "lodash.merge": "^4.6.2",
         "nanoid": "^5.1.5",
-        "ow": "^2.0.0",
         "p-limit": "^6.2.0",
         "proxy-chain": "^2.5.8",
         "quick-lru": "^7.0.1",
         "tiny-typed-emitter": "^2.1.0",
-        "tslib": "^2.8.1"
+        "tslib": "^2.8.1",
+        "zod": "^4.5.4"
     },
     "peerDependencies": {
         "playwright": "*",
@@ -64,5 +64,5 @@
             }
         }
     },
-    "gitHead": "8e04fea33d3b7ca5a386a941c990e9212275e221"
+    "gitHead": "5b29925251e92eb69252045f4980153844f58462"
 }

package/playwright/playwright-browser.d.ts

@@ -9,10 +9,8 @@ export interface BrowserOptions {
  * Browser wrapper created to have consistent API with persistent and non-persistent contexts.
  */
 export declare class PlaywrightBrowser extends EventEmitter {
-    private _browserContext;
-    private _version;
-    private _isConnected;
-    private _browserType?;
+    #private;
+    /** @internal */
     constructor(options: BrowserOptions);
     [Symbol.asyncDispose](): Promise<void>;
     close(): Promise<void>;
@@ -20,7 +18,7 @@ export declare class PlaywrightBrowser extends EventEmitter {
     isConnected(): boolean;
     version(): string;
     /** @internal */
-    _setBrowserType(browserType: BrowserType): void;
+    setBrowserType(browserType: BrowserType): void;
     browserType(): BrowserType;
     newPage(...args: Parameters<BrowserContext['newPage']>): ReturnType<BrowserContext['newPage']>;
     newContext(): Promise<never>;
@@ -28,4 +26,3 @@ export declare class PlaywrightBrowser extends EventEmitter {
     startTracing(): Promise<never>;
     stopTracing(): Promise<never>;
 }
-//# sourceMappingURL=playwright-browser.d.ts.map

package/playwright/playwright-browser.js

@@ -3,17 +3,18 @@ import { EventEmitter } from 'node:events';
  * Browser wrapper created to have consistent API with persistent and non-persistent contexts.
  */
 export class PlaywrightBrowser extends EventEmitter {
-    _browserContext;
-    _version;
-    _isConnected = true;
-    _browserType;
+    #browserContext;
+    #version;
+    #isConnected = true;
+    #browserType;
+    /** @internal */
     constructor(options) {
         super();
         const { browserContext, version } = options;
-        this._browserContext = browserContext;
-        this._version = version;
-        this._browserContext.once('close', () => {
-            this._isConnected = false;
+        this.#browserContext = browserContext;
+        this.#version = version;
+        this.#browserContext.once('close', () => {
+            this.#isConnected = false;
             this.emit('disconnected');
         });
     }
@@ -21,26 +22,26 @@ export class PlaywrightBrowser extends EventEmitter {
         await this.close();
     }
     async close() {
-        await this._browserContext.close();
+        await this.#browserContext.close();
     }
     contexts() {
-        return [this._browserContext];
+        return [this.#browserContext];
     }
     isConnected() {
-        return this._isConnected;
+        return this.#isConnected;
     }
     version() {
-        return this._version;
+        return this.#version;
     }
     /** @internal */
-    _setBrowserType(browserType) {
-        this._browserType = browserType;
+    setBrowserType(browserType) {
+        this.#browserType = browserType;
     }
     browserType() {
-        return this._browserType;
+        return this.#browserType;
     }
     async newPage(...args) {
-        return this._browserContext.newPage(...args);
+        return this.#browserContext.newPage(...args);
     }
     async newContext() {
         throw new Error('Function `newContext()` is not available in incognito mode');
@@ -55,4 +56,3 @@ export class PlaywrightBrowser extends EventEmitter {
         throw new Error('Function `stopTracing()` is not available in incognito mode');
     }
 }
-//# sourceMappingURL=playwright-browser.js.map

package/playwright/playwright-controller.d.ts

@@ -4,6 +4,7 @@ import type { Browser, BrowserType, Page } from 'playwright';
 import { BrowserController } from '../abstract-classes/browser-controller.js';
 import type { SafeParameters } from '../utils.js';
 export declare class PlaywrightController extends BrowserController<BrowserType, SafeParameters<BrowserType['launch']>[0], Browser> {
+    /** @internal */
     normalizeProxyOptions(proxyUrl: string | undefined, pageOptions: any): Record<string, unknown>;
     protected _newPage(contextOptions?: SafeParameters<Browser['newPage']>[0]): Promise<Page>;
     protected _close(): Promise<void>;
@@ -11,4 +12,3 @@ export declare class PlaywrightController extends BrowserController<BrowserType,
     protected _getCookies(page: Page): Promise<Cookie[]>;
     protected _setCookies(page: Page, cookies: Cookie[]): Promise<void>;
 }
-//# sourceMappingURL=playwright-controller.d.ts.map

package/playwright/playwright-controller.js

@@ -2,6 +2,7 @@ import { tryCancel } from '@apify/timeout';
 import { BrowserController } from '../abstract-classes/browser-controller.js';
 import { anonymizeProxySugar } from '../anonymize-proxy.js';
 export class PlaywrightController extends BrowserController {
+    /** @internal */
     normalizeProxyOptions(proxyUrl, pageOptions) {
         if (!proxyUrl) {
             return {};
@@ -11,7 +12,7 @@ export class PlaywrightController extends BrowserController {
         const password = decodeURIComponent(url.password);
         return {
             proxy: {
-                server: url.origin,
+                server: `${url.protocol}//${url.host}`,
                 username,
                 password,
                 bypass: pageOptions?.proxy?.bypass,
@@ -29,8 +30,12 @@ export class PlaywrightController extends BrowserController {
                 ...this.launchContext.launchOptions,
                 ...contextOptions,
             };
+            // Remote browsers handle their own proxy — don't inject local proxy settings into context
+            if (this.launchContext.isRemote) {
+                delete contextOptions?.proxy;
+            }
             if (contextOptions?.proxy) {
-                const [anonymizedProxyUrl, closeProxy] = await anonymizeProxySugar(contextOptions.proxy.server, contextOptions.proxy.username, contextOptions.proxy.password);
+                const [anonymizedProxyUrl, closeProxy] = await anonymizeProxySugar(contextOptions.proxy.server, contextOptions.proxy.username, contextOptions.proxy.password, { ignoreProxyCertificate: this.launchContext.ignoreProxyCertificate });
                 if (anonymizedProxyUrl) {
                     contextOptions.proxy = {
                         server: anonymizedProxyUrl,
@@ -42,9 +47,9 @@ export class PlaywrightController extends BrowserController {
         }
         try {
             const page = await this.browser.newPage(contextOptions);
-            page.once('close', async () => {
-                this.activePages--;
-                await close();
+            this.registerPageTeardown(page, close);
+            page.once('close', () => {
+                this.registerPageClosed(page);
             });
             tryCancel();
             return page;
@@ -70,4 +75,3 @@ export class PlaywrightController extends BrowserController {
         return context.addCookies(cookies);
     }
 }
-//# sourceMappingURL=playwright-controller.js.map

package/playwright/playwright-plugin.d.ts

@@ -1,17 +1,22 @@
 // @ts-ignore optional peer dependency or compatibility with es2022
 import type { Browser as PlaywrightBrowser, BrowserType } from 'playwright';
 import { BrowserPlugin } from '../abstract-classes/browser-plugin.js';
-import type { createProxyServerForContainers } from '../container-proxy-server.js';
 import type { LaunchContext } from '../launch-context.js';
+import type { RemoteConnection, RemoteConnectionParameters } from '../remote-browser-pool.js';
 import type { SafeParameters } from '../utils.js';
 import { PlaywrightController } from './playwright-controller.js';
 export declare class PlaywrightPlugin extends BrowserPlugin<BrowserType, SafeParameters<BrowserType['launch']>[0], PlaywrightBrowser> {
-    private _browserVersion?;
-    _containerProxyServer?: Awaited<ReturnType<typeof createProxyServerForContainers>>;
+    #private;
+    /**
+     * Playwright remote connections only support incognito pages — `connect()` / `connectOverCDP()` don't
+     * accept persistent contexts. Force it on (and inform the user) when wired for a remote connection.
+     *
+     * @internal
+     */
+    useRemoteConnection(connection: RemoteConnection, parameters?: RemoteConnectionParameters): void;
     protected _launch(launchContext: LaunchContext<BrowserType>): Promise<PlaywrightBrowser>;
-    private _throwOnFailedLaunch;
+    private throwOnFailedLaunch;
     createController(): PlaywrightController;
-    protected _addProxyToLaunchOptions(launchContext: LaunchContext<BrowserType>): Promise<void>;
-    protected _isChromiumBasedBrowser(): boolean;
+    protected addProxyToLaunchOptions(launchContext: LaunchContext<BrowserType>): Promise<void>;
+    protected isChromiumBasedBrowser(): boolean;
 }
-//# sourceMappingURL=playwright-plugin.d.ts.map