browser-use 0.2.0 → 0.3.0

package/dist/browser/profile.js

@@ -1,7 +1,9 @@
 import fs from 'node:fs';
 import { promises as fsp } from 'node:fs';
 import path from 'node:path';
+import os from 'node:os';
 import https from 'node:https';
+import { randomUUID } from 'node:crypto';
 import AdmZip from 'adm-zip';
 import { CONFIG } from '../config.js';
 import { observe_debug } from '../observability.js';
@@ -9,6 +11,7 @@ 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 DOMAIN_OPTIMIZATION_THRESHOLD = 100;
 export const CHROME_DISABLED_COMPONENTS = [
     'AcceptCHFrame',
     'AutoExpandDetailsElement',
@@ -39,6 +42,7 @@ export const CHROME_DISABLED_COMPONENTS = [
     'OverscrollHistoryNavigation',
     'InfiniteSessionRestore',
     'ExtensionDisableUnsupportedDeveloper',
+    'ExtensionManifestV2Unsupported',
 ];
 export const CHROME_HEADLESS_ARGS = ['--headless=new'];
 export const CHROME_DOCKER_ARGS = [
@@ -86,8 +90,6 @@ export const CHROME_DEFAULT_ARGS = [
     '--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',
@@ -129,19 +131,39 @@ 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',
+        url: 'https://clients2.google.com/service/update2/crx?response=redirect&prodversion=133&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',
+        url: 'https://clients2.google.com/service/update2/crx?response=redirect&prodversion=133&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',
+        url: 'https://clients2.google.com/service/update2/crx?response=redirect&prodversion=133&acceptformat=crx3&x=id%3Dlckanjgmijmafbedllaakclkaicjfmnk%26uc',
+    },
+    {
+        name: 'Force Background Tab',
+        id: 'gidlfommnbibbmegmgajdbikelkdcmcl',
+        url: 'https://clients2.google.com/service/update2/crx?response=redirect&prodversion=133&acceptformat=crx3&x=id%3Dgidlfommnbibbmegmgajdbikelkdcmcl%26uc',
     },
 ];
+const getEnableDefaultExtensionsDefault = () => {
+    const envValue = process.env.BROWSER_USE_DISABLE_EXTENSIONS;
+    if (typeof envValue === 'undefined') {
+        return true;
+    }
+    const normalized = envValue.trim().toLowerCase();
+    if (normalized === '' ||
+        normalized === '0' ||
+        normalized === 'false' ||
+        normalized === 'no' ||
+        normalized === 'off') {
+        return true;
+    }
+    return false;
+};
 const parseDisplayEnv = () => {
     const width = process.env.BROWSER_USE_SCREEN_WIDTH;
     const height = process.env.BROWSER_USE_SCREEN_HEIGHT;
@@ -318,8 +340,10 @@ const DEFAULT_BROWSER_PROFILE_OPTIONS = {
     disable_security: false,
     deterministic_rendering: false,
     allowed_domains: null,
+    prohibited_domains: null,
+    block_ip_addresses: false,
     keep_alive: null,
-    enable_default_extensions: true,
+    enable_default_extensions: getEnableDefaultExtensionsDefault(),
     window_size: null,
     window_height: null,
     window_width: null,
@@ -329,7 +353,7 @@ const DEFAULT_BROWSER_PROFILE_OPTIONS = {
     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,
+    wait_between_actions: 0.1,
     include_dynamic_attributes: true,
     highlight_elements: true,
     viewport_expansion: 500,
@@ -349,6 +373,17 @@ 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));
+const normalizeDomainEntry = (entry) => String(entry ?? '')
+    .trim()
+    .toLowerCase();
+const optimizeDomainList = (value) => {
+    const cleaned = value.map(normalizeDomainEntry).filter(Boolean);
+    if (cleaned.length >= DOMAIN_OPTIMIZATION_THRESHOLD) {
+        logger.warning(`Optimizing domain list with ${cleaned.length} entries to a Set for O(1) matching`);
+        return new Set(cleaned);
+    }
+    return cleaned;
+};
 export class BrowserProfile {
     options;
     constructor(init = {}) {
@@ -369,9 +404,24 @@ export class BrowserProfile {
             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),
+            allowed_domains: Array.isArray(init.allowed_domains)
+                ? optimizeDomainList(init.allowed_domains)
+                : init.allowed_domains instanceof Set
+                    ? new Set(Array.from(init.allowed_domains)
+                        .map(normalizeDomainEntry)
+                        .filter(Boolean))
+                    : defaults.allowed_domains,
+            prohibited_domains: Array.isArray(init.prohibited_domains)
+                ? optimizeDomainList(init.prohibited_domains)
+                : init.prohibited_domains instanceof Set
+                    ? new Set(Array.from(init.prohibited_domains)
+                        .map(normalizeDomainEntry)
+                        .filter(Boolean))
+                    : defaults.prohibited_domains,
             window_position: init.window_position ?? defaults.window_position,
         };
         this.options.id = init.id ?? uuid7str();
+        this.ensureDefaultDownloadsPath();
         this.applyLegacyWindowSize();
         this.warnStorageStateUserDataDirConflict();
         this.warnUserDataDirNonDefault();
@@ -393,6 +443,12 @@ export class BrowserProfile {
     get allowed_domains() {
         return this.options.allowed_domains;
     }
+    get prohibited_domains() {
+        return this.options.prohibited_domains;
+    }
+    get block_ip_addresses() {
+        return this.options.block_ip_addresses;
+    }
     get cookies_file() {
         return this.options.cookies_file;
     }
@@ -435,12 +491,12 @@ export class BrowserProfile {
     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.');
+            logger.warning('⚠️ BrowserProfile(window_width=..., window_height=...) are deprecated, use BrowserProfile(window_size={"width": 1920, "height": 1080}) 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;
+            newSize.width = newSize.width || window_width || 1920;
+            newSize.height = newSize.height || window_height || 1080;
             this.options.window_size = newSize;
         }
     }
@@ -482,6 +538,17 @@ export class BrowserProfile {
             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.');
         }
     }
+    ensureDefaultDownloadsPath() {
+        if (this.options.downloads_path) {
+            return;
+        }
+        let downloadsPath = path.join(os.tmpdir(), `browser-use-downloads-${randomUUID().slice(0, 8)}`);
+        while (fs.existsSync(downloadsPath)) {
+            downloadsPath = path.join(os.tmpdir(), `browser-use-downloads-${randomUUID().slice(0, 8)}`);
+        }
+        fs.mkdirSync(downloadsPath, { recursive: true });
+        this.options.downloads_path = downloadsPath;
+    }
     getDefaultArgsList() {
         const ignore = this.options.ignore_default_args;
         if (Array.isArray(ignore)) {
@@ -671,7 +738,7 @@ export class BrowserProfile {
             const displaySize = get_display_size();
             const hasScreen = Boolean(displaySize);
             this.options.screen = this.options.screen ||
-                displaySize || { width: 1280, height: 1100 };
+                displaySize || { width: 1920, height: 1080 };
             if (this.options.headless === null) {
                 this.options.headless = !hasScreen;
             }
@@ -701,7 +768,7 @@ export class BrowserProfile {
             useViewport = !this.options.no_viewport;
             if (useViewport) {
                 this.options.viewport = this.options.viewport ||
-                    this.options.screen || { width: 1280, height: 1100 };
+                    this.options.screen || { width: 1920, height: 1080 };
                 this.options.device_scale_factor =
                     this.options.device_scale_factor || 1.0;
             }

package/dist/browser/session-manager.d.ts

@@ -0,0 +1,85 @@
+import type { TabInfo } from './views.js';
+export type SessionManagerTargetSource = 'tab' | 'cdp' | 'unknown';
+export interface SessionManagerTarget {
+    target_id: string;
+    target_type: string;
+    url: string;
+    title: string;
+    attached: boolean;
+    source: SessionManagerTargetSource;
+    first_seen_at: string;
+    last_seen_at: string;
+}
+export interface SessionManagerChannel {
+    session_id: string;
+    target_id: string;
+    attached_at: string;
+    last_seen_at: string;
+}
+export interface TargetAttachedPayload {
+    target_id: string;
+    session_id?: string | null;
+    target_type?: string;
+    url?: string;
+    title?: string;
+}
+export interface TargetDetachedPayload {
+    target_id: string;
+    session_id?: string | null;
+}
+export interface TargetInfoChangedPayload {
+    target_id: string;
+    target_type?: string;
+    url?: string;
+    title?: string;
+}
+export declare class SessionManager {
+    private _targets;
+    private _sessions;
+    private _target_sessions;
+    private _session_to_target;
+    private _page_targets;
+    private _tab_target_ids;
+    private _focused_target_id;
+    sync_tabs(tabs: TabInfo[], current_tab_index: number, target_id_factory: (page_id: number) => string): void;
+    handle_target_attached(payload: TargetAttachedPayload): void;
+    handle_target_detached(payload: TargetDetachedPayload): void;
+    handle_target_info_changed(payload: TargetInfoChangedPayload): void;
+    upsert_target(init: {
+        target_id: string;
+        target_type?: string;
+        url?: string;
+        title?: string;
+        attached?: boolean;
+        source?: SessionManagerTargetSource;
+    }): SessionManagerTarget;
+    remove_target(target_id: string): void;
+    upsert_session(session_id: string, target_id: string): void;
+    remove_session(session_id: string): void;
+    bind_page_to_target(page_id: number, target_id: string): void;
+    unbind_page(page_id: number): void;
+    set_focused_target(target_id: string | null): void;
+    get_focused_target_id(): string | null;
+    get_target(target_id: string): SessionManagerTarget | null;
+    get_session(session_id: string): SessionManagerChannel | null;
+    get_target_id_for_session(session_id: string): string | null;
+    get_target_id_for_page(page_id: number): string | null;
+    get_sessions_for_target(target_id: string): SessionManagerChannel[];
+    get_all_targets(): {
+        target_id: string;
+        target_type: string;
+        url: string;
+        title: string;
+        attached: boolean;
+        source: SessionManagerTargetSource;
+        first_seen_at: string;
+        last_seen_at: string;
+    }[];
+    get_all_sessions(): {
+        session_id: string;
+        target_id: string;
+        attached_at: string;
+        last_seen_at: string;
+    }[];
+    clear(): void;
+}

package/dist/browser/session-manager.js

@@ -0,0 +1,208 @@
+export class SessionManager {
+    _targets = new Map();
+    _sessions = new Map();
+    _target_sessions = new Map();
+    _session_to_target = new Map();
+    _page_targets = new Map();
+    _tab_target_ids = new Set();
+    _focused_target_id = null;
+    sync_tabs(tabs, current_tab_index, target_id_factory) {
+        const nextTabTargetIds = new Set();
+        const seenPageIds = new Set();
+        for (const tab of tabs) {
+            const target_id = tab.target_id ?? target_id_factory(tab.page_id);
+            tab.target_id = target_id;
+            nextTabTargetIds.add(target_id);
+            seenPageIds.add(tab.page_id);
+            this.upsert_target({
+                target_id,
+                target_type: 'page',
+                url: tab.url,
+                title: tab.title,
+                attached: true,
+                source: 'tab',
+            });
+            this.bind_page_to_target(tab.page_id, target_id);
+        }
+        for (const target_id of [...this._tab_target_ids]) {
+            if (!nextTabTargetIds.has(target_id)) {
+                this.remove_target(target_id);
+            }
+        }
+        this._tab_target_ids = nextTabTargetIds;
+        for (const page_id of [...this._page_targets.keys()]) {
+            if (!seenPageIds.has(page_id)) {
+                this._page_targets.delete(page_id);
+            }
+        }
+        const currentTab = tabs[current_tab_index] ?? null;
+        this._focused_target_id = currentTab?.target_id ?? null;
+    }
+    handle_target_attached(payload) {
+        this.upsert_target({
+            target_id: payload.target_id,
+            target_type: payload.target_type ?? 'page',
+            url: payload.url ?? '',
+            title: payload.title ?? '',
+            attached: true,
+            source: 'cdp',
+        });
+        if (payload.session_id) {
+            this.upsert_session(payload.session_id, payload.target_id);
+        }
+    }
+    handle_target_detached(payload) {
+        if (payload.session_id) {
+            this.remove_session(payload.session_id);
+        }
+        const targetSessions = this._target_sessions.get(payload.target_id);
+        if (targetSessions && targetSessions.size > 0) {
+            return;
+        }
+        const target = this._targets.get(payload.target_id);
+        if (!target) {
+            return;
+        }
+        if (target.source === 'tab' &&
+            this._tab_target_ids.has(payload.target_id)) {
+            target.attached = false;
+            target.last_seen_at = new Date().toISOString();
+            this._targets.set(payload.target_id, target);
+            return;
+        }
+        this.remove_target(payload.target_id);
+    }
+    handle_target_info_changed(payload) {
+        const current = this._targets.get(payload.target_id);
+        this.upsert_target({
+            target_id: payload.target_id,
+            target_type: payload.target_type ?? current?.target_type ?? 'page',
+            url: payload.url ?? current?.url ?? '',
+            title: payload.title ?? current?.title ?? '',
+            attached: current?.attached ?? true,
+            source: current?.source ?? 'cdp',
+        });
+    }
+    upsert_target(init) {
+        const now = new Date().toISOString();
+        const existing = this._targets.get(init.target_id);
+        const nextTarget = {
+            target_id: init.target_id,
+            target_type: init.target_type ?? existing?.target_type ?? 'page',
+            url: init.url ?? existing?.url ?? '',
+            title: init.title ?? existing?.title ?? '',
+            attached: init.attached ?? existing?.attached ?? true,
+            source: init.source ?? existing?.source ?? 'unknown',
+            first_seen_at: existing?.first_seen_at ?? now,
+            last_seen_at: now,
+        };
+        this._targets.set(init.target_id, nextTarget);
+        return nextTarget;
+    }
+    remove_target(target_id) {
+        this._targets.delete(target_id);
+        this._tab_target_ids.delete(target_id);
+        const sessions = this._target_sessions.get(target_id);
+        if (sessions) {
+            for (const session_id of sessions) {
+                this._sessions.delete(session_id);
+                this._session_to_target.delete(session_id);
+            }
+        }
+        this._target_sessions.delete(target_id);
+        for (const [page_id, mapped_target_id] of this._page_targets.entries()) {
+            if (mapped_target_id === target_id) {
+                this._page_targets.delete(page_id);
+            }
+        }
+        if (this._focused_target_id === target_id) {
+            this._focused_target_id = null;
+        }
+    }
+    upsert_session(session_id, target_id) {
+        const now = new Date().toISOString();
+        const existing = this._sessions.get(session_id);
+        this._sessions.set(session_id, {
+            session_id,
+            target_id,
+            attached_at: existing?.attached_at ?? now,
+            last_seen_at: now,
+        });
+        const previous_target_id = this._session_to_target.get(session_id);
+        if (previous_target_id && previous_target_id !== target_id) {
+            const previousSessions = this._target_sessions.get(previous_target_id);
+            previousSessions?.delete(session_id);
+            if (previousSessions && previousSessions.size === 0) {
+                this._target_sessions.delete(previous_target_id);
+            }
+        }
+        this._session_to_target.set(session_id, target_id);
+        const sessions = this._target_sessions.get(target_id) ?? new Set();
+        sessions.add(session_id);
+        this._target_sessions.set(target_id, sessions);
+    }
+    remove_session(session_id) {
+        const target_id = this._session_to_target.get(session_id);
+        this._session_to_target.delete(session_id);
+        this._sessions.delete(session_id);
+        if (!target_id) {
+            return;
+        }
+        const sessions = this._target_sessions.get(target_id);
+        if (!sessions) {
+            return;
+        }
+        sessions.delete(session_id);
+        if (sessions.size === 0) {
+            this._target_sessions.delete(target_id);
+        }
+    }
+    bind_page_to_target(page_id, target_id) {
+        this._page_targets.set(page_id, target_id);
+    }
+    unbind_page(page_id) {
+        this._page_targets.delete(page_id);
+    }
+    set_focused_target(target_id) {
+        this._focused_target_id = target_id;
+    }
+    get_focused_target_id() {
+        return this._focused_target_id;
+    }
+    get_target(target_id) {
+        return this._targets.get(target_id) ?? null;
+    }
+    get_session(session_id) {
+        return this._sessions.get(session_id) ?? null;
+    }
+    get_target_id_for_session(session_id) {
+        return this._session_to_target.get(session_id) ?? null;
+    }
+    get_target_id_for_page(page_id) {
+        return this._page_targets.get(page_id) ?? null;
+    }
+    get_sessions_for_target(target_id) {
+        const session_ids = this._target_sessions.get(target_id);
+        if (!session_ids) {
+            return [];
+        }
+        return [...session_ids]
+            .map((session_id) => this._sessions.get(session_id))
+            .filter((session) => session != null);
+    }
+    get_all_targets() {
+        return [...this._targets.values()].map((target) => ({ ...target }));
+    }
+    get_all_sessions() {
+        return [...this._sessions.values()].map((session) => ({ ...session }));
+    }
+    clear() {
+        this._targets.clear();
+        this._sessions.clear();
+        this._target_sessions.clear();
+        this._session_to_target.clear();
+        this._page_targets.clear();
+        this._tab_target_ids.clear();
+        this._focused_target_id = null;
+    }
+}