Launch a Pure CDP Mode browser session. Must be called before any other tool. The browser is driven entirely over CDP (no WebDriver), which is SeleniumBase's most stealth/bot-detection-resistant mode. Args: url: Optional URL to open immediately on launch. headless: Run without a visible window. incognito: Launch in a private/incognito window. guest: Launch in Chrome guest mode. proxy: Proxy string, e.g. "USER:PASS@SERVER:PORT" or "SERVER:PORT". ad_block: Block ads.

Close the browser and end the session.

Navigate to the given URL in the web browser. If the URL doesn't start with a protocol (eg: https://), then https:// is automatically prefixed in before navigation. Waits until the initial HTML document is fully parsed and loaded. New pages visited will show up in browser navigation history. If the URL is invalid or the page can't load due to an issue, then the corresponding errors will be raised.

Reload the current page. Same as clicking the Reload button in the web browser. By default, ignores the browser cache on reload.

Go back one page in browser history. Same as clicking the Back button in the web browser.

Go forward one page in browser history. Same as clicking the Forward button in the web browser.

Get the browser's navigation history.

Get the URL of the current page.

Get the title of the current page.

Get the origin (scheme + host) of the current page.

Find one element and return its tag name, text, and outer HTML. Args: selector: CSS selector, or text to search for (CDP mode can match elements by visible text as well as by selector). best_match: When matching by text and multiple elements qualify, pick the one whose text length is closest to the search text. timeout: Seconds to wait for the element to appear.

Find all matching elements and return tag name + text for each.

Get the visible text within an element (default: whole page body). Raises an exception if the element isn't found within the default timeout.

Get the full HTML source of the current page.

Get the outer HTML of a specific element.

Get one attribute's value from an element.

Get all attributes of an element as a dict.

Get the count of how many elements on the page match the selector.

Return whether an element matching the selector exists in the DOM.

Return whether an element matching the selector is visible.

Return whether the specific text is visible within an element.

Get all linked URLs (a, link, img, script, meta) on the page.

Click an element matched by a CSS selector (or by text, e.g. 'a:contains("Sign in")'). If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element isn't found within the timeout.

Click an element only if it's currently visible; no-op otherwise. If a timeout is given, then waits up to that long for the element to appear first before performing the click.

Click every currently-visible element matching a selector, in order (e.g. checking every checkbox on a page). limit=0 means no limit.

Click the Nth element (1-indexed) matching a selector.

Click a link ( tag) by its visible text.

Clear a field and type text into it. If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element isn't found within the timeout.

Send keystrokes to an element without clearing it first. If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element isn't found within the timeout.

Set an input's value directly (e.g. for sliders, fast form fills). If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element isn't found within the timeout.

Clear an input field. If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element isn't found within the timeout.

Submit a form via a selector inside it.

Select a dropdown option by its visible text. Raises an exception if the element or option aren't found within the default timeout, which is 7 seconds.

Select a dropdown option by its value attribute. Raises an exception if the element or option aren't found within the default timeout, which is 7 seconds.

Select a dropdown option by its 0-based index. Raises an exception if the element or option aren't found within the default timeout, which is 7 seconds.

Move focus to an element. Raises an exception if the element isn't found within the default timeout.

Briefly highlight an element (useful when narrating actions on a visible/headed browser). Raises an exception if the element isn't found within the default timeout.

Click an element nested inside another (e.g. inside an iframe). Raises an exception if the element isn't found within the default timeout.

Wait until the element is present in the DOM. If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element isn't found within the timeout.

Wait until the element is visible on the page. If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element isn't visible within the timeout.

Wait until an element is no longer visible on the page. If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element is still visible after the timeout.

Wait until an element is removed from the DOM. If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element is still present after the timeout.

Wait until the text substring appears within an element. If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element isn't visible within the timeout.

Assert that an element is present in the DOM. If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element isn't found within the timeout.

Assert that an element is visible on the page. If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element isn't found within the timeout.

Assert that the text substring appears within the given element (with the matching selector) in the given timeout (seconds), with leading and trailing whitespace automatically ignored. If no selector given, then it defaults to "html" (CSS selector). If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element isn't found or assertion fails.

Assert that the text matches the element's text exactly (with leading/trailing whitespace automatically ignored) in the given timeout (seconds). If no selector given, then it defaults to "html" (CSS selector). If no timeout given (0 or None), then SeleniumBase uses 7 seconds. Raises an exception if the element isn't found or assertion fails.

Assert that the title matches the page title exactly, with leading and trailing whitespace ignored. Raises an exception if the expected title doesn't match the actual title within 7 seconds.

Assert that the url matches the current URL exactly. Raises an exception if the expected url doesn't match the actual url within 7 seconds.

Assert that the current URL contains the given substring. Raises an exception if the expected substring isn't found in the actual url within 7 seconds.

Get all cookies for the current session.

Clear all cookies.

Save current cookies to a file.

Load cookies from a previously saved file.

Get a value from the page's localStorage.

Set a value in the page's localStorage.

Get a value from the page's sessionStorage.

Set a value in the page's sessionStorage.

Scroll an element into view.

Scroll to the top of the page.

Scroll to the bottom of the page.

Scroll up by a relative amount.

Scroll down by a relative amount.

Get the current window's position and size.

Set the current window's position and size.

Maximize the browser window.

Minimize the browser window.

Open a new browser tab, optionally navigating and switching to it.

Switch to a tab by its index (as returned by get_tabs).

Switch to the most recently opened tab.

Close the currently active tab.

Get how many tabs are currently open.

Attempt to solve a captcha (e.g. Cloudflare Turnstile) on the page.

Save a screenshot of the current page.

Save the current page's HTML source to a file.

Print the current page to a PDF file.

Evaluate a JavaScript expression in the page context and return the result. Equivalent to execute_script. This method can run any arbitrary JavaScript on any site, so take any necessary precautions to prevent AI harnesses from running scripts that you don't want them to run.

Pause execution for a number of seconds.

Get the browser's current user agent string.