make iframe depth variable (#3026)

Auto-generated PR for: make iframe depth variable
    
<!-- This is an auto-generated description by cubic. -->
---

## Summary by cubic
Made iframe processing limits configurable and removed hard-coded caps.
Defaults now allow up to 100 iframes and 5 levels of depth to capture
more content while still preventing crashes.

- **New Features**
- Added BrowserProfile.max_iframes and BrowserProfile.max_iframe_depth.
- Threaded settings through BrowserSession and DOM watchdog to
DomService.
- DomService uses these values to cap snapshot documents and recursion,
with warnings when limiting.

<!-- End of auto-generated description by cubic. -->

Author: MagMueller

browser_use/browser/profile.py

@@ -590,6 +590,15 @@ class BrowserProfile(BrowserConnectArgs, BrowserLaunchPersistentContextArgs, Bro
 		default=True,
 		description='Enable cross-origin iframe support (OOPIF/Out-of-Process iframes). When False, only same-origin frames are processed to avoid complexity and hanging.',
 	)
+	max_iframes: int = Field(
+		default=100,
+		description='Maximum number of iframe documents to process to prevent crashes.',
+	)
+	max_iframe_depth: int = Field(
+		ge=0,
+		default=5,
+		description='Maximum depth for cross-origin iframe recursion (default: 5 levels deep).',
+	)
 
 	# --- Page load/wait timings ---
 

browser_use/browser/session.py

@@ -270,6 +270,9 @@ def __init__(
 		cross_origin_iframes: bool | None = None,
 		highlight_elements: bool | None = None,
 		paint_order_filtering: bool | None = None,
+		# Iframe processing limits
+		max_iframes: int | None = None,
+		max_iframe_depth: int | None = None,
 	):
 		# Following the same pattern as AgentSettings in service.py
 		# Only pass non-None values to avoid validation errors

browser_use/browser/watchdogs/dom_watchdog.py

@@ -361,6 +361,8 @@ async def _build_dom_tree_without_highlights(self, previous_state: SerializedDOM
 					logger=self.logger,
 					cross_origin_iframes=self.browser_session.browser_profile.cross_origin_iframes,
 					paint_order_filtering=self.browser_session.browser_profile.paint_order_filtering,
+					max_iframes=self.browser_session.browser_profile.max_iframes,
+					max_iframe_depth=self.browser_session.browser_profile.max_iframe_depth,
 				)
 
 			# Get serialized DOM tree using the service

browser_use/dom/service.py

@@ -27,9 +27,7 @@
 if TYPE_CHECKING:
 	from browser_use.browser.session import BrowserSession
 
-# Global limits to prevent iframe explosion
-MAX_TOTAL_IFRAMES = 3  # Maximum number of iframe documents to process (very conservative to prevent explosions)
-MAX_IFRAME_DEPTH = 1  # Maximum depth for cross-origin iframe recursion (only 1 level deep)
+# Note: iframe limits are now configurable via BrowserProfile.max_iframes and BrowserProfile.max_iframe_depth
 
 
 class DomService:
@@ -49,11 +47,15 @@ def __init__(
 		logger: logging.Logger | None = None,
 		cross_origin_iframes: bool = False,
 		paint_order_filtering: bool = True,
+		max_iframes: int = 100,
+		max_iframe_depth: int = 5,
 	):
 		self.browser_session = browser_session
 		self.logger = logger or browser_session.logger
 		self.cross_origin_iframes = cross_origin_iframes
 		self.paint_order_filtering = paint_order_filtering
+		self.max_iframes = max_iframes
+		self.max_iframe_depth = max_iframe_depth
 
 	async def __aenter__(self):
 		return self
@@ -419,12 +421,12 @@ def create_dom_tree_request():
 		# DEBUG: Log snapshot info and limit documents to prevent explosion
 		if snapshot and 'documents' in snapshot:
 			original_doc_count = len(snapshot['documents'])
-			# Limit to MAX_TOTAL_IFRAMES documents to prevent iframe explosion
-			if original_doc_count > MAX_TOTAL_IFRAMES:
+			# Limit to max_iframes documents to prevent iframe explosion
+			if original_doc_count > self.max_iframes:
 				self.logger.warning(
-					f'⚠️ Limiting processing of {original_doc_count} iframes on page to only first {MAX_TOTAL_IFRAMES} to prevent crashes!'
+					f'⚠️ Limiting processing of {original_doc_count} iframes on page to only first {self.max_iframes} to prevent crashes!'
 				)
-				snapshot['documents'] = snapshot['documents'][:MAX_TOTAL_IFRAMES]
+				snapshot['documents'] = snapshot['documents'][: self.max_iframes]
 
 			total_nodes = sum(len(doc.get('nodes', [])) for doc in snapshot['documents'])
 			self.logger.debug(f'🔍 DEBUG: Snapshot contains {len(snapshot["documents"])} frames with {total_nodes} total nodes')
@@ -641,9 +643,9 @@ async def _construct_enhanced_node(
 				self.cross_origin_iframes and node['nodeName'].upper() == 'IFRAME' and node.get('contentDocument', None) is None
 			):  # None meaning there is no content
 				# Check iframe depth to prevent infinite recursion
-				if iframe_depth >= MAX_IFRAME_DEPTH:
+				if iframe_depth >= self.max_iframe_depth:
 					self.logger.debug(
-						f'Skipping iframe at depth {iframe_depth} to prevent infinite recursion (max depth: {MAX_IFRAME_DEPTH})'
+						f'Skipping iframe at depth {iframe_depth} to prevent infinite recursion (max depth: {self.max_iframe_depth})'
 					)
 				else:
 					# Check if iframe is visible and large enough (>= 200px in both dimensions)