Skip to main content
Version: Next

BrowserController

An abstract base class for managing browser instance and their pages.

Hierarchy

Index

Methods

close

  • async close(*, force): None
  • Close the browser.


    Parameters

    • optionalkeyword-onlyforce: bool = False

      Whether to force close all open pages before closing the browser.

    Returns None

new_page

  • async new_page(browser_new_context_options, proxy_info): Page
  • Create a new page with the given context options.


    Parameters

    Returns Page

    Page: The newly created page.

register_page_closed

  • register_page_closed(page): None
  • Stop tracking the page as open.

    Implementations must call it from the page's close event. The BrowserPool also calls it when closing the page never finishes, in which case that event never arrives, so it can be called more than once for the same page.


    Parameters

    • page: Page

      The page that is no longer open.

    Returns None

Properties

AUTOMATION_LIBRARY

AUTOMATION_LIBRARY: str | None

The name of the automation library that the controller is using.

browser_type

browser_type: BrowserType

Return the type of the browser.

has_free_capacity

has_free_capacity: bool

Return if the browser has free capacity to open a new page.

idle_time

idle_time: timedelta

Return the idle time of the browser controller.

is_browser_connected

is_browser_connected: bool

Return if the browser is closed.

is_opening_pages

is_opening_pages: bool

Return if the browser has any new_page calls currently in flight.

last_page_opened_at

last_page_opened_at: datetime

Return the time when the last page was opened.

pages

pages: Sequence[Page]

Return the list of opened pages.

pages_count

pages_count: int

Return the number of currently open pages.

total_opened_pages

total_opened_pages: int

Return the total number of pages opened since the browser was launched.