Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

5.5 KB
Raw Blame
"""Tests for browser configuration environment variables."""

import json
from pathlib import Path

import pytest

from browser_use.browser import BrowserSession
from browser_use.browser.profile import (
	BrowserProfile,
	_get_enable_default_extensions_default,
	_get_headless_default,
)
from browser_use.config import load_browser_use_config

TRUTHY_STRINGS = ['true', 'True', 'TRUE', '1', 'yes', 'on']
FALSY_STRINGS = ['false', 'False', 'FALSE', '0', 'no', 'off', '']


class TestConfigEnvVars:
	"""Tests for browser profile env var configuration."""

	def test_default_values_without_env(self, monkeypatch: pytest.MonkeyPatch):
		"""Verify default values when environment variables are unset."""
		monkeypatch.delenv('BROWSER_USE_DISABLE_EXTENSIONS', raising=False)
		monkeypatch.delenv('BROWSER_USE_HEADLESS', raising=False)

		assert _get_enable_default_extensions_default() is True
		assert _get_headless_default() is None

	@pytest.mark.parametrize(
		'env_var,getter,expected',
		[
			('BROWSER_USE_DISABLE_EXTENSIONS', _get_enable_default_extensions_default, False),
			('BROWSER_USE_HEADLESS', _get_headless_default, True),
		],
	)
	def test_env_var_truthy_values(
		self,
		monkeypatch: pytest.MonkeyPatch,
		env_var: str,
		getter,
		expected: bool,
	):
		"""Test truthy env var values are parsed correctly."""
		for val in TRUTHY_STRINGS:
			monkeypatch.setenv(env_var, val)
			assert getter() is expected, f'Failed for {env_var}={val}'

	@pytest.mark.parametrize(
		'env_var,getter,expected',
		[
			('BROWSER_USE_DISABLE_EXTENSIONS', _get_enable_default_extensions_default, True),
			('BROWSER_USE_HEADLESS', _get_headless_default, False),
		],
	)
	def test_env_var_falsy_values(
		self,
		monkeypatch: pytest.MonkeyPatch,
		env_var: str,
		getter,
		expected: bool,
	):
		"""Test falsy env var values are parsed correctly."""
		for val in FALSY_STRINGS:
			monkeypatch.setenv(env_var, val)
			assert getter() is expected, f'Failed for {env_var}={val}'

	@pytest.mark.parametrize(
		'env_var,attr_name,truthy_val,falsy_val',
		[
			('BROWSER_USE_DISABLE_EXTENSIONS', 'enable_default_extensions', False, True),
			('BROWSER_USE_HEADLESS', 'headless', True, False),
		],
	)
	def test_browser_profile_and_session_env_var(
		self,
		monkeypatch: pytest.MonkeyPatch,
		env_var: str,
		attr_name: str,
		truthy_val: bool,
		falsy_val: bool,
	):
		"""Test that BrowserProfile and BrowserSession pick up env vars."""
		# Test truthy env value
		monkeypatch.setenv(env_var, 'true')
		profile = BrowserProfile()
		assert getattr(profile, attr_name) is truthy_val
		session = BrowserSession()
		assert getattr(session.browser_profile, attr_name) is truthy_val

		# Test falsy env value
		monkeypatch.setenv(env_var, 'false')
		profile_falsy = BrowserProfile()
		assert getattr(profile_falsy, attr_name) is falsy_val
		session_falsy = BrowserSession()
		assert getattr(session_falsy.browser_profile, attr_name) is falsy_val

	@pytest.mark.parametrize(
		'env_var,attr_name,env_val,explicit_arg,expected',
		[
			('BROWSER_USE_DISABLE_EXTENSIONS', 'enable_default_extensions', 'true', {'enable_default_extensions': True}, True),
			('BROWSER_USE_DISABLE_EXTENSIONS', 'enable_default_extensions', 'false', {'enable_default_extensions': False}, False),
			('BROWSER_USE_HEADLESS', 'headless', 'true', {'headless': False}, False),
			('BROWSER_USE_HEADLESS', 'headless', 'false', {'headless': True}, True),
		],
	)
	def test_explicit_parameter_overrides_env_var(
		self,
		monkeypatch: pytest.MonkeyPatch,
		env_var: str,
		attr_name: str,
		env_val: str,
		explicit_arg: dict,
		expected: bool,
	):
		"""Test that explicit constructor parameters override env vars."""
		monkeypatch.setenv(env_var, env_val)
		profile = BrowserProfile(**explicit_arg)
		assert getattr(profile, attr_name) is expected

	@pytest.mark.parametrize('value,expected', [('true', True), ('false', False)])
	def test_mcp_disable_security_env_var(self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path, value: str, expected: bool):
		"""The documented MCP env var must reach the resolved browser profile."""
		monkeypatch.setenv('BROWSER_USE_CONFIG_PATH', str(tmp_path / 'config.json'))
		monkeypatch.setenv('BROWSER_USE_DISABLE_SECURITY', value)

		config = load_browser_use_config()

		assert config['browser_profile']['disable_security'] is expected
		assert BrowserProfile(**config['browser_profile']).disable_security is expected

	@pytest.mark.parametrize(
		'env_value,persisted,expected',
		[(None, None, False), (None, True, True), (None, False, False), ('false', True, False), ('true', False, True)],
	)
	def test_mcp_disable_security_precedence(
		self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path, env_value: str | None, persisted: bool | None, expected: bool
	):
		"""Unset preserves stored policy; an explicit env value overrides it."""
		config_path = tmp_path / 'config.json'
		monkeypatch.setenv('BROWSER_USE_CONFIG_PATH', str(config_path))
		monkeypatch.delenv('BROWSER_USE_DISABLE_SECURITY', raising=False)
		load_browser_use_config()
		stored = json.loads(config_path.read_text())
		if persisted is not None:
			default_profile = next(profile for profile in stored['browser_profile'].values() if profile.get('default'))
			default_profile['disable_security'] = persisted
			config_path.write_text(json.dumps(stored))
		if env_value is not None:
			monkeypatch.setenv('BROWSER_USE_DISABLE_SECURITY', env_value)

		resolved = load_browser_use_config()['browser_profile']

		assert BrowserProfile(**resolved).disable_security is expected
		if env_value is None and persisted is None:
			assert 'disable_security' not in resolved
		assert json.loads(config_path.read_text()) == stored