browser-use 0.0.1 → 0.1.0

package/dist/browser/profile.js

@@ -0,0 +1,815 @@
+import fs from 'node:fs';
+import { promises as fsp } from 'node:fs';
+import path from 'node:path';
+import https from 'node:https';
+import AdmZip from 'adm-zip';
+import { CONFIG } from '../config.js';
+import { observe_debug } from '../observability.js';
+import { createLogger } from '../logging-config.js';
+import { log_pretty_path, uuid7str } from '../utils.js';
+const logger = createLogger('browser_use.browser.profile');
+export const CHROME_DEBUG_PORT = 9242;
+export const CHROME_DISABLED_COMPONENTS = [
+    'AcceptCHFrame',
+    'AutoExpandDetailsElement',
+    'AvoidUnnecessaryBeforeUnloadCheckSync',
+    'CertificateTransparencyComponentUpdater',
+    'DestroyProfileOnBrowserClose',
+    'DialMediaRouteProvider',
+    'ExtensionManifestV2Disabled',
+    'GlobalMediaControls',
+    'HttpsUpgrades',
+    'ImprovedCookieControls',
+    'LazyFrameLoading',
+    'LensOverlay',
+    'MediaRouter',
+    'PaintHolding',
+    'ThirdPartyStoragePartitioning',
+    'Translate',
+    'AutomationControlled',
+    'BackForwardCache',
+    'OptimizationHints',
+    'ProcessPerSiteUpToMainFrameThreshold',
+    'InterestFeedContentSuggestions',
+    'CalculateNativeWinOcclusion',
+    'HeavyAdPrivacyMitigations',
+    'PrivacySandboxSettings4',
+    'AutofillServerCommunication',
+    'CrashReporting',
+    'OverscrollHistoryNavigation',
+    'InfiniteSessionRestore',
+    'ExtensionDisableUnsupportedDeveloper',
+];
+export const CHROME_HEADLESS_ARGS = ['--headless=new'];
+export const CHROME_DOCKER_ARGS = [
+    '--no-sandbox',
+    '--disable-gpu-sandbox',
+    '--disable-setuid-sandbox',
+    '--disable-dev-shm-usage',
+    '--no-xshm',
+    '--no-zygote',
+    '--disable-site-isolation-trials',
+];
+export const CHROME_DISABLE_SECURITY_ARGS = [
+    '--disable-site-isolation-trials',
+    '--disable-web-security',
+    '--disable-features=IsolateOrigins,site-per-process',
+    '--allow-running-insecure-content',
+    '--ignore-certificate-errors',
+    '--ignore-ssl-errors',
+    '--ignore-certificate-errors-spki-list',
+];
+export const CHROME_DETERMINISTIC_RENDERING_ARGS = [
+    '--deterministic-mode',
+    '--js-flags=--random-seed=1157259159',
+    '--force-device-scale-factor=2',
+    '--enable-webgl',
+    '--font-render-hinting=none',
+    '--force-color-profile=srgb',
+];
+export const CHROME_DEFAULT_ARGS = [
+    '--disable-field-trial-config',
+    '--disable-background-networking',
+    '--disable-background-timer-throttling',
+    '--disable-backgrounding-occluded-windows',
+    '--disable-back-forward-cache',
+    '--disable-breakpad',
+    '--disable-client-side-phishing-detection',
+    '--disable-component-extensions-with-background-pages',
+    '--disable-component-update',
+    '--no-default-browser-check',
+    '--disable-dev-shm-usage',
+    '--disable-hang-monitor',
+    '--disable-ipc-flooding-protection',
+    '--disable-popup-blocking',
+    '--disable-prompt-on-repost',
+    '--disable-renderer-backgrounding',
+    '--metrics-recording-only',
+    '--no-first-run',
+    '--password-store=basic',
+    '--use-mock-keychain',
+    '--no-service-autorun',
+    '--export-tagged-pdf',
+    '--disable-search-engine-choice-screen',
+    '--unsafely-disable-devtools-self-xss-warnings',
+    '--enable-features=NetworkService,NetworkServiceInProcess',
+    '--enable-network-information-downlink-max',
+    '--test-type=gpu',
+    '--disable-sync',
+    '--allow-legacy-extension-manifests',
+    '--allow-pre-commit-input',
+    '--disable-blink-features=AutomationControlled',
+    '--install-autogenerated-theme=0,0,0',
+    '--log-level=2',
+    '--disable-focus-on-load',
+    '--disable-window-activation',
+    '--generate-pdf-document-outline',
+    '--no-pings',
+    '--ash-no-nudges',
+    '--disable-infobars',
+    '--simulate-outdated-no-au="Tue, 31 Dec 2099 23:59:59 GMT"',
+    '--hide-crash-restore-bubble',
+    '--suppress-message-center-popups',
+    '--disable-domain-reliability',
+    '--disable-datasaver-prompt',
+    '--disable-speech-synthesis-api',
+    '--disable-speech-api',
+    '--disable-print-preview',
+    '--safebrowsing-disable-auto-update',
+    '--disable-external-intent-requests',
+    '--disable-desktop-notifications',
+    '--noerrdialogs',
+    '--silent-debugger-extension-api',
+    '--disable-extensions-http-throttling',
+    '--extensions-on-chrome-urls',
+    '--disable-default-apps',
+    `--disable-features=${CHROME_DISABLED_COMPONENTS.join(',')}`,
+];
+const DEFAULT_EXTENSIONS = [
+    {
+        name: 'uBlock Origin',
+        id: 'cjpalhdlnbpafiamejdnhcphjbkeiagm',
+        url: 'https://clients2.google.com/service/update2/crx?response=redirect&prodversion=130&acceptformat=crx3&x=id%3Dcjpalhdlnbpafiamejdnhcphjbkeiagm%26uc',
+    },
+    {
+        name: "I still don't care about cookies",
+        id: 'edibdbjcniadpccecjdfdjjppcpchdlm',
+        url: 'https://clients2.google.com/service/update2/crx?response=redirect&prodversion=130&acceptformat=crx3&x=id%3Dedibdbjcniadpccecjdfdjjppcpchdlm%26uc',
+    },
+    {
+        name: 'ClearURLs',
+        id: 'lckanjgmijmafbedllaakclkaicjfmnk',
+        url: 'https://clients2.google.com/service/update2/crx?response=redirect&prodversion=130&acceptformat=crx3&x=id%3Dlckanjgmijmafbedllaakclkaicjfmnk%26uc',
+    },
+];
+const parseDisplayEnv = () => {
+    const width = process.env.BROWSER_USE_SCREEN_WIDTH;
+    const height = process.env.BROWSER_USE_SCREEN_HEIGHT;
+    if (width && height) {
+        const parsedWidth = Number(width);
+        const parsedHeight = Number(height);
+        if (!Number.isNaN(parsedWidth) && !Number.isNaN(parsedHeight)) {
+            return { width: parsedWidth, height: parsedHeight };
+        }
+    }
+    return null;
+};
+export const get_display_size = () => {
+    // Node.js lacks a portable cross-platform API for monitor size detection.
+    // Support manual overrides via env vars and fall back to null otherwise.
+    return parseDisplayEnv();
+};
+export const get_window_adjustments = () => {
+    if (process.platform === 'darwin') {
+        return [-4, 24];
+    }
+    if (process.platform === 'win32') {
+        return [-8, 0];
+    }
+    return [0, 0];
+};
+const validate_url = (url, schemes = []) => {
+    try {
+        const parsed = new URL(url);
+        if (schemes.length > 0 && parsed.protocol) {
+            const lowered = parsed.protocol.replace(':', '').toLowerCase();
+            if (!schemes.map((s) => s.toLowerCase()).includes(lowered)) {
+                throw new Error();
+            }
+        }
+        return url;
+    }
+    catch {
+        throw new Error(`Invalid URL format: ${url}`);
+    }
+};
+const validate_float_range = (value, min, max) => {
+    if (value < min || value > max) {
+        throw new Error(`Value ${value} outside of range ${min}-${max}`);
+    }
+    return value;
+};
+const validate_cli_arg = (arg) => {
+    if (!arg.startsWith('--')) {
+        throw new Error(`Invalid CLI argument: ${arg} (should start with --)`);
+    }
+    return arg;
+};
+export var ColorScheme;
+(function (ColorScheme) {
+    ColorScheme["LIGHT"] = "light";
+    ColorScheme["DARK"] = "dark";
+    ColorScheme["NO_PREFERENCE"] = "no-preference";
+    ColorScheme["NULL"] = "null";
+})(ColorScheme || (ColorScheme = {}));
+export var Contrast;
+(function (Contrast) {
+    Contrast["NO_PREFERENCE"] = "no-preference";
+    Contrast["MORE"] = "more";
+    Contrast["NULL"] = "null";
+})(Contrast || (Contrast = {}));
+export var ReducedMotion;
+(function (ReducedMotion) {
+    ReducedMotion["REDUCE"] = "reduce";
+    ReducedMotion["NO_PREFERENCE"] = "no-preference";
+    ReducedMotion["NULL"] = "null";
+})(ReducedMotion || (ReducedMotion = {}));
+export var ForcedColors;
+(function (ForcedColors) {
+    ForcedColors["ACTIVE"] = "active";
+    ForcedColors["NONE"] = "none";
+    ForcedColors["NULL"] = "null";
+})(ForcedColors || (ForcedColors = {}));
+export var ServiceWorkers;
+(function (ServiceWorkers) {
+    ServiceWorkers["ALLOW"] = "allow";
+    ServiceWorkers["BLOCK"] = "block";
+})(ServiceWorkers || (ServiceWorkers = {}));
+export var RecordHarContent;
+(function (RecordHarContent) {
+    RecordHarContent["OMIT"] = "omit";
+    RecordHarContent["EMBED"] = "embed";
+    RecordHarContent["ATTACH"] = "attach";
+})(RecordHarContent || (RecordHarContent = {}));
+export var RecordHarMode;
+(function (RecordHarMode) {
+    RecordHarMode["FULL"] = "full";
+    RecordHarMode["MINIMAL"] = "minimal";
+})(RecordHarMode || (RecordHarMode = {}));
+export var BrowserChannel;
+(function (BrowserChannel) {
+    BrowserChannel["CHROMIUM"] = "chromium";
+    BrowserChannel["CHROME"] = "chrome";
+    BrowserChannel["CHROME_BETA"] = "chrome-beta";
+    BrowserChannel["CHROME_DEV"] = "chrome-dev";
+    BrowserChannel["CHROME_CANARY"] = "chrome-canary";
+    BrowserChannel["MSEDGE"] = "msedge";
+    BrowserChannel["MSEDGE_BETA"] = "msedge-beta";
+    BrowserChannel["MSEDGE_DEV"] = "msedge-dev";
+    BrowserChannel["MSEDGE_CANARY"] = "msedge-canary";
+})(BrowserChannel || (BrowserChannel = {}));
+export const BROWSERUSE_DEFAULT_CHANNEL = BrowserChannel.CHROMIUM;
+const DEFAULT_PERMISSIONS = [
+    'clipboard-read',
+    'clipboard-write',
+    'notifications',
+];
+const DEFAULT_IGNORE_ARGS = [
+    '--enable-automation',
+    '--disable-extensions',
+    '--hide-scrollbars',
+    '--disable-features=AcceptCHFrame,AutoExpandDetailsElement,AvoidUnnecessaryBeforeUnloadCheckSync,CertificateTransparencyComponentUpdater,DeferRendererTasksAfterInput,DestroyProfileOnBrowserClose,DialMediaRouteProvider,ExtensionManifestV2Disabled,GlobalMediaControls,HttpsUpgrades,ImprovedCookieControls,LazyFrameLoading,LensOverlay,MediaRouter,PaintHolding,ThirdPartyStoragePartitioning,Translate',
+];
+const DEFAULT_BROWSER_PROFILE_OPTIONS = {
+    accept_downloads: true,
+    offline: false,
+    strict_selectors: false,
+    proxy: null,
+    permissions: DEFAULT_PERMISSIONS.slice(),
+    bypass_csp: false,
+    client_certificates: [],
+    extra_http_headers: {},
+    http_credentials: null,
+    ignore_https_errors: false,
+    java_script_enabled: true,
+    base_url: null,
+    service_workers: ServiceWorkers.ALLOW,
+    user_agent: null,
+    screen: null,
+    viewport: null,
+    no_viewport: null,
+    device_scale_factor: null,
+    is_mobile: false,
+    has_touch: false,
+    locale: null,
+    geolocation: null,
+    timezone_id: null,
+    color_scheme: ColorScheme.LIGHT,
+    contrast: Contrast.NO_PREFERENCE,
+    reduced_motion: ReducedMotion.NO_PREFERENCE,
+    forced_colors: ForcedColors.NONE,
+    record_har_content: RecordHarContent.EMBED,
+    record_har_mode: RecordHarMode.FULL,
+    record_har_omit_content: false,
+    record_har_path: null,
+    record_har_url_filter: null,
+    record_video_dir: null,
+    record_video_size: null,
+    headers: null,
+    slow_mo: 0,
+    timeout: 30000,
+    env: null,
+    executable_path: null,
+    headless: null,
+    args: [],
+    ignore_default_args: DEFAULT_IGNORE_ARGS.slice(),
+    channel: null,
+    chromium_sandbox: !CONFIG.IN_DOCKER,
+    devtools: false,
+    downloads_path: null,
+    traces_dir: null,
+    handle_sighup: true,
+    handle_sigint: false,
+    handle_sigterm: false,
+    id: uuid7str(),
+    user_data_dir: CONFIG.BROWSER_USE_DEFAULT_USER_DATA_DIR,
+    storage_state: null,
+    stealth: false,
+    disable_security: false,
+    deterministic_rendering: false,
+    allowed_domains: null,
+    keep_alive: null,
+    enable_default_extensions: true,
+    window_size: null,
+    window_height: null,
+    window_width: null,
+    window_position: { width: 0, height: 0 },
+    default_navigation_timeout: null,
+    default_timeout: null,
+    minimum_wait_page_load_time: 0.25,
+    wait_for_network_idle_page_load_time: 0.5,
+    maximum_wait_page_load_time: 5.0,
+    wait_between_actions: 0.5,
+    include_dynamic_attributes: true,
+    highlight_elements: true,
+    viewport_expansion: 500,
+    profile_directory: 'Default',
+    cookies_file: null,
+};
+const argsAsDict = (args) => {
+    const result = {};
+    for (const arg of args) {
+        const [keyPart, valuePart = ''] = arg.split('=', 1);
+        const key = keyPart.trim().replace(/^-+/, '');
+        result[key] = valuePart.trim();
+    }
+    return result;
+};
+const argsAsList = (args) => Object.entries(args).map(([key, value]) => value
+    ? `--${key.replace(/^-+/, '')}=${value}`
+    : `--${key.replace(/^-+/, '')}`);
+const cloneDefaultOptions = () => JSON.parse(JSON.stringify(DEFAULT_BROWSER_PROFILE_OPTIONS));
+export class BrowserProfile {
+    options;
+    constructor(init = {}) {
+        const defaults = cloneDefaultOptions();
+        this.options = {
+            ...defaults,
+            ...init,
+            permissions: init.permissions
+                ? [...init.permissions]
+                : defaults.permissions,
+            client_certificates: init.client_certificates
+                ? [...init.client_certificates]
+                : [],
+            extra_http_headers: init.extra_http_headers
+                ? { ...init.extra_http_headers }
+                : {},
+            args: init.args ? init.args.map(validate_cli_arg) : [],
+            ignore_default_args: Array.isArray(init.ignore_default_args)
+                ? init.ignore_default_args.map(validate_cli_arg)
+                : (init.ignore_default_args ?? defaults.ignore_default_args),
+            window_position: init.window_position ?? defaults.window_position,
+        };
+        this.options.id = init.id ?? uuid7str();
+        this.applyLegacyWindowSize();
+        this.warnStorageStateUserDataDirConflict();
+        this.warnUserDataDirNonDefault();
+        this.warnDeterministicRenderingWeirdness();
+    }
+    toString() {
+        return `BrowserProfile#${this.options.id.slice(-4)}`;
+    }
+    describe() {
+        const shortDir = this.options.user_data_dir
+            ? log_pretty_path(this.options.user_data_dir)
+            : '<incognito>';
+        return `BrowserProfile#${this.options.id.slice(-4)}(user_data_dir=${shortDir}, headless=${this.options.headless})`;
+    }
+    get config() {
+        return this.options;
+    }
+    // Public getters for commonly accessed properties
+    get allowed_domains() {
+        return this.options.allowed_domains;
+    }
+    get cookies_file() {
+        return this.options.cookies_file;
+    }
+    get default_navigation_timeout() {
+        return this.options.default_navigation_timeout;
+    }
+    get downloads_path() {
+        return this.options.downloads_path;
+    }
+    get highlight_elements() {
+        return this.options.highlight_elements;
+    }
+    get keep_alive() {
+        return this.options.keep_alive;
+    }
+    set keep_alive(value) {
+        this.options.keep_alive = value;
+    }
+    get maximum_wait_page_load_time() {
+        return this.options.maximum_wait_page_load_time;
+    }
+    get traces_dir() {
+        return this.options.traces_dir;
+    }
+    get user_data_dir() {
+        return this.options.user_data_dir;
+    }
+    get viewport_expansion() {
+        return this.options.viewport_expansion;
+    }
+    get viewport() {
+        return this.options.viewport;
+    }
+    get wait_for_network_idle_page_load_time() {
+        return this.options.wait_for_network_idle_page_load_time;
+    }
+    get window_size() {
+        return this.options.window_size;
+    }
+    applyLegacyWindowSize() {
+        const { window_width, window_height } = this.options;
+        if (window_width || window_height) {
+            logger.warning('⚠️ BrowserProfile(window_width=..., window_height=...) are deprecated, use BrowserProfile(window_size={"width": 1280, "height": 1100}) instead.');
+            const newSize = {
+                ...(this.options.window_size ?? { width: 0, height: 0 }),
+            };
+            newSize.width = newSize.width || window_width || 1280;
+            newSize.height = newSize.height || window_height || 1100;
+            this.options.window_size = newSize;
+        }
+    }
+    warnStorageStateUserDataDirConflict() {
+        const hasStorageState = this.options.storage_state !== null;
+        const hasUserDataDir = Boolean(this.options.user_data_dir &&
+            !this.options.user_data_dir.toLowerCase().includes('tmp'));
+        const hasCookiesFile = this.options.cookies_file !== null;
+        const staticSource = hasCookiesFile
+            ? 'cookies_file'
+            : hasStorageState
+                ? 'storage_state'
+                : null;
+        if (staticSource && hasUserDataDir) {
+            logger.warning(`⚠️ BrowserSession(...) was passed both ${staticSource} AND user_data_dir. ${staticSource}=${this.options.storage_state ?? this.options.cookies_file} will forcibly overwrite cookies/localStorage/sessionStorage in user_data_dir=${this.options.user_data_dir}. For multiple browsers in parallel, use only storage_state with user_data_dir=None, or use a separate user_data_dir for each browser and set storage_state=None.`);
+        }
+    }
+    warnUserDataDirNonDefault() {
+        const isNotDefault = Boolean(this.options.executable_path ||
+            (this.options.channel &&
+                this.options.channel !== BROWSERUSE_DEFAULT_CHANNEL));
+        if (this.options.user_data_dir === CONFIG.BROWSER_USE_DEFAULT_USER_DATA_DIR &&
+            isNotDefault) {
+            const alternateName = this.options.executable_path
+                ? path
+                    .basename(this.options.executable_path)
+                    .toLowerCase()
+                    .replace(/ /g, '-')
+                : this.options.channel
+                    ? this.options.channel.toLowerCase()
+                    : 'none';
+            logger.warning(`⚠️ ${this} Changing user_data_dir=${log_pretty_path(this.options.user_data_dir)} ➡️ .../default-${alternateName} to avoid ${alternateName.toUpperCase()} corruping default profile created by ${BROWSERUSE_DEFAULT_CHANNEL}`);
+            const dir = path.dirname(CONFIG.BROWSER_USE_DEFAULT_USER_DATA_DIR);
+            this.options.user_data_dir = path.join(dir, `default-${alternateName}`);
+        }
+    }
+    warnDeterministicRenderingWeirdness() {
+        if (this.options.deterministic_rendering) {
+            logger.warning('⚠️ BrowserSession(deterministic_rendering=True) is NOT RECOMMENDED. It breaks many sites and increases chances of getting blocked by anti-bot systems. It hardcodes the JS random seed and forces browsers across Linux/Mac/Windows to use the same font rendering engine so that identical screenshots can be generated.');
+        }
+    }
+    getDefaultArgsList() {
+        const ignore = this.options.ignore_default_args;
+        if (Array.isArray(ignore)) {
+            const ignoreSet = new Set(ignore);
+            return CHROME_DEFAULT_ARGS.filter((arg) => !ignoreSet.has(arg));
+        }
+        if (ignore === true) {
+            return [];
+        }
+        return [...CHROME_DEFAULT_ARGS];
+    }
+    getWindowSizeArgs() {
+        const args = [];
+        const size = this.options.window_size;
+        if (size && size.width && size.height) {
+            args.push(`--window-size=${size.width},${size.height}`);
+        }
+        else if (!this.options.headless) {
+            args.push('--start-maximized');
+        }
+        return args;
+    }
+    getWindowPositionArgs() {
+        const args = [];
+        const position = this.options.window_position;
+        if (position &&
+            typeof position.width === 'number' &&
+            typeof position.height === 'number') {
+            args.push(`--window-position=${position.width},${position.height}`);
+        }
+        return args;
+    }
+    async getExtensionArgs() {
+        const extensionPaths = await this.ensureDefaultExtensionsDownloaded();
+        const args = [
+            '--enable-extensions',
+            '--disable-extensions-file-access-check',
+            '--disable-extensions-http-throttling',
+            '--enable-extension-activity-logging',
+        ];
+        if (extensionPaths.length) {
+            args.push(`--load-extension=${extensionPaths.join(',')}`);
+        }
+        return args;
+    }
+    async ensureDefaultExtensionsDownloaded() {
+        const cacheDir = CONFIG.BROWSER_USE_EXTENSIONS_DIR;
+        await fsp.mkdir(cacheDir, { recursive: true });
+        const extensionPaths = [];
+        const loadedNames = [];
+        for (const ext of DEFAULT_EXTENSIONS) {
+            const extDir = path.join(cacheDir, ext.id);
+            const manifestPath = path.join(extDir, 'manifest.json');
+            if (fs.existsSync(extDir) && fs.existsSync(manifestPath)) {
+                extensionPaths.push(extDir);
+                loadedNames.push(ext.name);
+                continue;
+            }
+            const crxFile = path.join(cacheDir, `${ext.id}.crx`);
+            try {
+                if (!fs.existsSync(crxFile)) {
+                    logger.info(`📦 Downloading ${ext.name} extension...`);
+                    await this.downloadExtension(ext.url, crxFile);
+                }
+                if (fs.existsSync(crxFile)) {
+                    logger.info(`📂 Extracting ${ext.name} extension...`);
+                    await this.extractExtension(crxFile, extDir);
+                    extensionPaths.push(extDir);
+                    loadedNames.push(ext.name);
+                }
+            }
+            catch (error) {
+                logger.warning(`⚠️ Failed to setup ${ext.name} extension: ${error.message}`);
+            }
+        }
+        if (extensionPaths.length) {
+            logger.info(`✅ Extensions ready: ${extensionPaths.length} extensions loaded (${loadedNames.join(', ')})`);
+        }
+        else {
+            logger.warning('⚠️ No default extensions could be loaded');
+        }
+        return extensionPaths;
+    }
+    downloadExtension(url, outputPath, redirectCount = 0) {
+        const maxRedirects = 5;
+        return new Promise((resolve, reject) => {
+            https
+                .get(url, (response) => {
+                const { statusCode, headers } = response;
+                if (statusCode &&
+                    statusCode >= 300 &&
+                    statusCode < 400 &&
+                    headers.location &&
+                    redirectCount < maxRedirects) {
+                    response.resume();
+                    this.downloadExtension(headers.location, outputPath, redirectCount + 1)
+                        .then(resolve)
+                        .catch(reject);
+                    return;
+                }
+                if (!statusCode || statusCode >= 400) {
+                    reject(new Error(`Failed to download extension (status ${statusCode ?? 'unknown'})`));
+                    return;
+                }
+                const chunks = [];
+                response.on('data', (chunk) => chunks.push(chunk));
+                response.on('end', async () => {
+                    try {
+                        await fsp.writeFile(outputPath, Buffer.concat(chunks));
+                        resolve();
+                    }
+                    catch (error) {
+                        reject(error);
+                    }
+                });
+            })
+                .on('error', reject);
+        });
+    }
+    async extractExtension(crxPath, extractDir) {
+        if (fs.existsSync(extractDir)) {
+            await fsp.rm(extractDir, { recursive: true, force: true });
+        }
+        await fsp.mkdir(extractDir, { recursive: true });
+        const buffer = await fsp.readFile(crxPath);
+        try {
+            const zip = new AdmZip(buffer);
+            zip.extractAllTo(extractDir, true);
+        }
+        catch {
+            const zipBuffer = this.stripCrxHeader(buffer);
+            const zip = new AdmZip(zipBuffer);
+            zip.extractAllTo(extractDir, true);
+        }
+        if (!fs.existsSync(path.join(extractDir, 'manifest.json'))) {
+            throw new Error('No manifest.json found in extension');
+        }
+    }
+    stripCrxHeader(buffer) {
+        const magic = buffer.subarray(0, 4).toString();
+        if (magic !== 'Cr24') {
+            throw new Error('Invalid CRX file format');
+        }
+        const version = buffer.readUInt32LE(4);
+        if (version === 2) {
+            const pubkeyLen = buffer.readUInt32LE(8);
+            const sigLen = buffer.readUInt32LE(12);
+            const offset = 16 + pubkeyLen + sigLen;
+            return buffer.subarray(offset);
+        }
+        if (version === 3) {
+            const headerLen = buffer.readUInt32LE(8);
+            const offset = 12 + headerLen;
+            return buffer.subarray(offset);
+        }
+        throw new Error(`Unsupported CRX version: ${version}`);
+    }
+    async getArgs() {
+        const defaultArgs = this.getDefaultArgsList();
+        const preConversionArgs = [
+            ...defaultArgs,
+            ...this.options.args,
+            `--profile-directory=${this.options.profile_directory}`,
+            ...(CONFIG.IN_DOCKER || !this.options.chromium_sandbox
+                ? CHROME_DOCKER_ARGS
+                : []),
+            ...(this.options.headless ? CHROME_HEADLESS_ARGS : []),
+            ...(this.options.disable_security ? CHROME_DISABLE_SECURITY_ARGS : []),
+            ...(this.options.deterministic_rendering
+                ? CHROME_DETERMINISTIC_RENDERING_ARGS
+                : []),
+            ...this.getWindowSizeArgs(),
+            ...this.getWindowPositionArgs(),
+            ...(this.options.enable_default_extensions
+                ? await this.getExtensionArgs()
+                : []),
+        ];
+        const finalArgs = argsAsList(argsAsDict(preConversionArgs));
+        return finalArgs;
+    }
+    async detect_display_configuration() {
+        const runner = observe_debug({
+            name: 'detect_display_configuration',
+            ignore_input: true,
+            ignore_output: true,
+        })(async () => {
+            const displaySize = get_display_size();
+            const hasScreen = Boolean(displaySize);
+            this.options.screen = this.options.screen ||
+                displaySize || { width: 1280, height: 1100 };
+            if (this.options.headless === null) {
+                this.options.headless = !hasScreen;
+            }
+            if (this.options.headless) {
+                this.options.viewport =
+                    this.options.viewport ||
+                        this.options.window_size ||
+                        this.options.screen;
+                this.options.window_position = null;
+                this.options.window_size = null;
+                this.options.no_viewport = false;
+            }
+            else {
+                this.options.window_size =
+                    this.options.window_size || this.options.screen;
+                this.options.no_viewport = this.options.no_viewport ?? true;
+                this.options.viewport = this.options.no_viewport
+                    ? null
+                    : this.options.viewport;
+            }
+            let useViewport = Boolean(this.options.headless) ||
+                Boolean(this.options.viewport) ||
+                Boolean(this.options.device_scale_factor);
+            if (this.options.no_viewport === null) {
+                this.options.no_viewport = !useViewport;
+            }
+            useViewport = !this.options.no_viewport;
+            if (useViewport) {
+                this.options.viewport = this.options.viewport ||
+                    this.options.screen || { width: 1280, height: 1100 };
+                this.options.device_scale_factor =
+                    this.options.device_scale_factor || 1.0;
+            }
+            else {
+                this.options.viewport = null;
+                this.options.device_scale_factor = null;
+                this.options.screen = null;
+            }
+            if (this.options.headless && this.options.no_viewport) {
+                throw new Error('headless=True and no_viewport=True cannot both be set at the same time');
+            }
+        });
+        return runner.call(this);
+    }
+    cloneContextArgs() {
+        const o = this.options;
+        return {
+            accept_downloads: o.accept_downloads,
+            offline: o.offline,
+            strict_selectors: o.strict_selectors,
+            proxy: o.proxy ? { ...o.proxy } : null,
+            permissions: [...o.permissions],
+            bypass_csp: o.bypass_csp,
+            client_certificates: o.client_certificates
+                ? [...o.client_certificates]
+                : [],
+            extra_http_headers: { ...o.extra_http_headers },
+            http_credentials: o.http_credentials ? { ...o.http_credentials } : null,
+            ignore_https_errors: o.ignore_https_errors,
+            java_script_enabled: o.java_script_enabled,
+            base_url: o.base_url,
+            service_workers: o.service_workers,
+            user_agent: o.user_agent,
+            screen: o.screen ? { ...o.screen } : null,
+            viewport: o.viewport ? { ...o.viewport } : null,
+            no_viewport: o.no_viewport,
+            device_scale_factor: o.device_scale_factor,
+            is_mobile: o.is_mobile,
+            has_touch: o.has_touch,
+            locale: o.locale,
+            geolocation: o.geolocation ? { ...o.geolocation } : null,
+            timezone_id: o.timezone_id,
+            color_scheme: o.color_scheme,
+            contrast: o.contrast,
+            reduced_motion: o.reduced_motion,
+            forced_colors: o.forced_colors,
+            record_har_content: o.record_har_content,
+            record_har_mode: o.record_har_mode,
+            record_har_omit_content: o.record_har_omit_content,
+            record_har_path: o.record_har_path,
+            record_har_url_filter: o.record_har_url_filter,
+            record_video_dir: o.record_video_dir,
+            record_video_size: o.record_video_size
+                ? { ...o.record_video_size }
+                : null,
+        };
+    }
+    cloneLaunchArgs(args) {
+        const o = this.options;
+        return {
+            env: o.env ? { ...o.env } : null,
+            executable_path: o.executable_path,
+            headless: o.headless,
+            args,
+            ignore_default_args: Array.isArray(o.ignore_default_args)
+                ? [...o.ignore_default_args]
+                : o.ignore_default_args,
+            channel: o.channel,
+            chromium_sandbox: o.chromium_sandbox,
+            devtools: o.devtools,
+            slow_mo: o.slow_mo,
+            timeout: o.timeout,
+            proxy: o.proxy ? { ...o.proxy } : null,
+            downloads_path: o.downloads_path,
+            traces_dir: o.traces_dir,
+            handle_sighup: o.handle_sighup,
+            handle_sigint: o.handle_sigint,
+            handle_sigterm: o.handle_sigterm,
+        };
+    }
+    kwargs_for_new_context() {
+        return {
+            ...this.cloneContextArgs(),
+            storage_state: this.options.storage_state
+                ? typeof this.options.storage_state === 'string'
+                    ? this.options.storage_state
+                    : { ...this.options.storage_state }
+                : null,
+        };
+    }
+    kwargs_for_connect() {
+        return {
+            headers: this.options.headers ? { ...this.options.headers } : null,
+            slow_mo: this.options.slow_mo,
+            timeout: this.options.timeout,
+        };
+    }
+    async kwargs_for_launch() {
+        const args = await this.getArgs();
+        return this.cloneLaunchArgs(args);
+    }
+    async kwargs_for_launch_persistent_context() {
+        const args = await this.getArgs();
+        return {
+            ...this.cloneContextArgs(),
+            ...this.cloneLaunchArgs(args),
+            user_data_dir: this.options.user_data_dir,
+        };
+    }
+}
+export const DEFAULT_BROWSER_PROFILE = new BrowserProfile();