All Parameters

​

Browser (BrowserSession)

​

Key Methods

from browser_use import Browser

browser = Browser()
await browser.start()

# Page management
page = await browser.new_page("https://example.com")
pages = await browser.get_pages()
current = await browser.get_current_page()
await browser.close_page(page)

# To stop the browser session
await browser.stop()

​

Constructor Parameters

​

Page

​

Navigation

• goto(url: str) - Navigate to URL
• go_back(), go_forward(), reload() - History navigation

​

Element Finding

• get_elements_by_css_selector(selector: str) -> list[Element] - CSS selector
• get_element(backend_node_id: int) -> Element - By CDP node ID
• get_element_by_prompt(prompt: str, llm) -> Element | None - AI-powered
• must_get_element_by_prompt(prompt: str, llm) -> Element - AI (raises if not found)

​

JavaScript & Controls

• evaluate(page_function: str, *args) -> str - Execute JS (arrow function format)
• press(key: str) - Send keyboard input (“Enter”, “Control+A”)
• set_viewport_size(width: int, height: int) - Set viewport
• screenshot(format='jpeg', quality=None) -> str - Take screenshot

​

Information

• get_url() -> str, get_title() -> str - Page info
• mouse -> Mouse - Get mouse interface

​

AI Features

• extract_content(prompt: str, structured_output: type[T], llm) -> T - Extract data

​

Element

​

Interactions

• click(button='left', click_count=1, modifiers=None) - Click element
• fill(text: str, clear_existing=True) - Fill input
• hover(), focus() - Mouse/focus actions
• check() - Toggle checkbox/radio
• select_option(values: str | list[str]) - Select dropdown options
• drag_to(target: Element | Position) - Drag and drop

​

Properties

• get_attribute(name: str) -> str | None - Get attribute
• get_bounding_box() -> BoundingBox | None - Position/size
• get_basic_info() -> ElementInfo - Complete element info
• screenshot(format='jpeg') -> str - Element screenshot

​

Mouse

​

Operations

• click(x: int, y: int, button='left', click_count=1) - Click at coordinates
• move(x: int, y: int, steps=1) - Move mouse
• down(button='left'), up(button='left') - Press/release buttons
• scroll(x=0, y=0, delta_x=None, delta_y=None) - Scroll at coordinates