Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
fix: handle locked Chrome profile copies
duyua9e89f3aaae2af
diff --git a/browser_use/browser/profile.py b/browser_use/browser/profile.pyindex 634eb6778..eda73dfcf 100644--- a/browser_use/browser/profile.py+++ b/browser_use/browser/profile.py@@ -3,6 +3,7 @@ import sysimport tempfilefrom collections.abc import Iterablefrom enum import Enum+from fnmatch import fnmatchfrom functools import cachefrom pathlib import Pathfrom typing import Annotated, Any, Literal, Self@@ -26,6 +27,13 @@ def _get_enable_default_extensions_default() -> bool:CHROME_DEBUG_PORT = 9242 # use a non-default port to avoid conflicts with other tools / devs using 9222DOMAIN_OPTIMIZATION_THRESHOLD = 100 # Convert domain lists to sets for O(1) lookup when >= this size+CHROME_PROFILE_TRANSIENT_FILE_PATTERNS = (+ 'Singleton*',+ '*.lock',+ '*-journal',+ 'LOCK',+ 'LOCKFILE',+)CHROME_DISABLED_COMPONENTS = [# Playwright defaults: https://github.com/microsoft/playwright/blob/41008eeddd020e2dee1c540f7c0cdfa337e99637/packages/playwright-core/src/server/chromium/chromiumSwitches.ts#L76# AcceptCHFrame,AutoExpandDetailsElement,AvoidUnnecessaryBeforeUnloadCheckSync,CertificateTransparencyComponentUpdater,DeferRendererTasksAfterInput,DestroyProfileOnBrowserClose,DialMediaRouteProvider,ExtensionManifestV2Disabled,GlobalMediaControls,HttpsUpgrades,ImprovedCookieControls,LazyFrameLoading,LensOverlay,MediaRouter,PaintHolding,ThirdPartyStoragePartitioning,Translate@@ -77,6 +85,34 @@ CHROME_DISABLED_COMPONENTS = ['ExtensionManifestV2Unsupported',]++def _ignore_chrome_profile_transient_files(_src: str, names: list[str]) -> set[str]:+ """Skip Chrome lock/journal files that should not be copied into a temp profile."""+ return {name for name in names if any(fnmatch(name, pattern) for pattern in CHROME_PROFILE_TRANSIENT_FILE_PATTERNS)}+++def _is_chrome_profile_lock_error(error: BaseException) -> bool:+ """Detect Windows sharing violations or permission errors raised while copying a Chrome profile."""+ if isinstance(error, PermissionError):+ return True++ if getattr(error, 'winerror', None) == 32:+ return True++ # shutil.Error stores copy failures as (src, dst, message/exception) triples.+ for arg in getattr(error, 'args', ()):+ if isinstance(arg, (list, tuple)):+ for item in arg:+ if isinstance(item, (list, tuple)) and item:+ detail = item[-1]+ if isinstance(detail, BaseException) and _is_chrome_profile_lock_error(detail):+ return True+ if 'WinError 32' in str(detail) or 'being used by another process' in str(detail):+ return True++ return False++CHROME_HEADLESS_ARGS = ['--headless=new',]@@ -827,7 +863,22 @@ class BrowserProfile(BrowserConnectArgs, BrowserLaunchPersistentContextArgs, Broif path_original_profile.exists():import shutil- shutil.copytree(path_original_profile, path_temp_profile)+ try:+ shutil.copytree(+ path_original_profile,+ path_temp_profile,+ ignore=_ignore_chrome_profile_transient_files,+ )+ except (OSError, shutil.Error) as error:+ if not _is_chrome_profile_lock_error(error):+ raise++ shutil.rmtree(temp_dir, ignore_errors=True)+ raise RuntimeError(+ f'Unable to copy Chrome profile "{self.profile_directory}" because one or more files are locked. '+ 'Close any Chrome windows using this profile, or start browser-use with --cdp-url to connect to '+ 'an already-running browser instead of copying the profile.'+ ) from errorlocal_state_src = path_original_user_data / 'Local State'local_state_dst = Path(temp_dir) / 'Local State'if local_state_src.exists():diff --git a/tests/ci/browser/test_profile_copy.py b/tests/ci/browser/test_profile_copy.pynew file mode 100644index 000000000..c3938e740--- /dev/null+++ b/tests/ci/browser/test_profile_copy.py@@ -0,0 +1,62 @@+import shutil+from pathlib import Path++import pytest++from browser_use.browser import profile as profile_module+from browser_use.browser.profile import BrowserChannel, BrowserProfile+++def _create_chrome_user_data_dir(tmp_path: Path) -> Path:+ user_data_dir = tmp_path / 'Chrome User Data'+ default_profile = user_data_dir / 'Default'+ default_profile.mkdir(parents=True)+ (default_profile / 'Preferences').write_text('{"profile": "default"}')+ (user_data_dir / 'Local State').write_text('{"browser": "chrome"}')+ return user_data_dir+++def test_chrome_profile_copy_skips_transient_lock_files(tmp_path: Path) -> None:+ user_data_dir = _create_chrome_user_data_dir(tmp_path)+ default_profile = user_data_dir / 'Default'+ (default_profile / 'SingletonLock').write_text('locked')+ (default_profile / 'Cookies-journal').write_text('journal')++ browser_profile = BrowserProfile(+ user_data_dir=user_data_dir,+ channel=BrowserChannel.CHROME,+ headless=True,+ )++ temp_user_data_dir = Path(browser_profile.user_data_dir)+ try:+ assert (temp_user_data_dir / 'Default' / 'Preferences').read_text() == '{"profile": "default"}'+ assert (temp_user_data_dir / 'Local State').read_text() == '{"browser": "chrome"}'+ assert not (temp_user_data_dir / 'Default' / 'SingletonLock').exists()+ assert not (temp_user_data_dir / 'Default' / 'Cookies-journal').exists()+ finally:+ shutil.rmtree(temp_user_data_dir, ignore_errors=True)+++def test_chrome_profile_copy_lock_error_is_actionable(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:+ user_data_dir = _create_chrome_user_data_dir(tmp_path)+ temp_user_data_dir = tmp_path / 'browser-use-user-data-dir-test'++ def fake_mkdtemp(prefix: str) -> str:+ temp_user_data_dir.mkdir()+ return str(temp_user_data_dir)++ def fake_copytree(*_args: object, **_kwargs: object) -> None:+ raise PermissionError(13, 'The process cannot access the file because it is being used by another process')++ monkeypatch.setattr(profile_module.tempfile, 'mkdtemp', fake_mkdtemp)+ monkeypatch.setattr(shutil, 'copytree', fake_copytree)++ with pytest.raises(RuntimeError, match='Close any Chrome windows using this profile.*--cdp-url'):+ BrowserProfile(+ user_data_dir=user_data_dir,+ channel=BrowserChannel.CHROME,+ headless=True,+ )++ assert not temp_user_data_dir.exists()