> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dendrite.systems/llms.txt
> Use this file to discover all available pages before exploring further.
# Page
> Interact with web pages using natural language
The `Page` class represents a page in the Dendrite browser instance, it corresponds to a *tab* in a traditional browser browser. It provides methods for interacting with and manipulating webpages.
## Properties
### url
Get the current URL of the page.
**Usage**
```python theme={null}
current_url = page.url
```
**Returns**
* `str`: The current URL.
## Methods
### goto
Navigates the page to the specified URL, optionally in a new tab.
**Usage**
```python theme={null}
page = browser.goto("https://example.com", expected_page="Feed of example articles")
```
**Arguments**
* `url` (str): The URL to navigate to.
* `new_page` (bool, optional): Whether to open the URL in a new page. Defaults to False.
* `timeout` (float, optional): The maximum time (in milliseconds) to wait for the page to load. Defaults to 15000.
* `expected_page` (str, optional): A description of the expected page type for verification at runtime. Defaults to an empty string.
**Returns**
* [Page](/sdk-reference/python/page): The page object after navigation.
This method exists on the `Page` and `Dendrite` class. If invoked from a
`Dendrite` instance, it is performed on the *active* page
### new\_tab
Opens a new tab and navigates to the specified URL.
**Usage**
```python theme={null}
page = browser.new_tab("https://example.com", expected_page="Feed of example articles")
```
**Arguments**
* `url` (str): The URL to navigate to.
* `timeout` (float, optional): The maximum time (in milliseconds) to wait for the page to load. Defaults to 15000.
* `expected_page` (str, optional): A description of the expected page type for verification at runtime. Defaults to an empty string.
**Returns**
`InteractionResponse`: The response from the interaction.
**Raises**
`DendriteException`: If no suitable element is found or if the fill operation fails.
This method exists on the `Page` and `Dendrite` class. If invoked from a
`Dendrite` instance, it is performed on the *active* page
### click
Clicks an element on the active page based on the provided prompt.
**Usage**
```python theme={null}
browser.click("Search button in navbar")
```
**Arguments**
* `prompt` (str): The prompt describing the element to be clicked.
* `expected_outcome` (str, optional): The expected outcome of the click action.
* `use_cache` (bool, optional): Whether to use cached results for element retrieval. Defaults to True.
* `timeout` (int, optional): The timeout (in milliseconds) for the click operation. Defaults to 15000.
* `force` (bool, optional): Whether to force the click operation. Defaults to False.
**Returns**
`InteractionResponse`
This method exists on the `Page` and `Dendrite` class. If invoked from a
`Dendrite` instance, it is performed on the *active* page
### fill
Fills an element on the active page with the provided value based on the given prompt.
This method combines the functionality of `get_element` and `element.fill`,
allowing for a more concise way to interact with elements on the page.
**Usage**
```python theme={null}
query = "AI agent builders"
browser.fill("Search input", value=query)
```
**Arguments**
* `prompt` (str): The prompt describing the element to be filled.
* `value` (str): The value to fill the element with.
* `expected_outcome` (str, optional): The expected outcome of the fill action.
* `use_cache` (bool, optional): Whether to use cached results for element retrieval. Defaults to True.
* `max_retries` (int, optional): The maximum number of retry attempts for element retrieval. Defaults to 3.
* `timeout` (int, optional): The timeout (in milliseconds) for the fill operation. Defaults to 15000.
**Returns**
`InteractionResponse`: The response from the interaction.
**Raises**
`DendriteException`: If no suitable element is found or if the fill operation fails.
This method exists on the `Page` and `Dendrite` class. If invoked from a
`Dendrite` instance, it is performed on the *active* page
### fill\_fields
Fills multiple fields on the active page with the provided values.
This method iterates through the given dictionary of fields and their corresponding values,
making a separate fill request for each key-value pair.
**Usage**
```python theme={null}
browser.fill_fields({
"First name": "John",
"Last name:": "Doe",
"Age": 36,
"Occupation": "Firefighter"
})
```
**Paramaters**
`fields` (Dict\[str, Any]): A dictionary where each key is a field identifier (e.g., a prompt or selector) and each value is the content to fill in that field.
**Returns**
`None`
This method exists on the `Page` and `Dendrite` class. If invoked from a
`Dendrite` instance, it is performed on the *active* page
### extract
Extract data from the active page based on a prompt and optional type specification.
**Usage**
```python theme={null}
class Article(BaseModel):
title: str
content: str
author: str
published_at: Optional[datetime] = None
views: Optional[int] = 0
article = browser.extract("The article information", type_spec=Article)
print(article.title)
```
**Arguments**
* `prompt` (str, optional): The prompt to guide the extraction.
* `type_spec` ([TypeSpec](/sdk-reference/python/types/type-spec), optional): The type specification for the extracted data.
* `use_cache` (bool, optional): Whether to use cached results. Defaults to True.
**Returns**
[TypeSpec](/sdk-reference/python/types/type-spec) | Any: The response data as the specified type. Defaults to Any.
This method exists on the `Page` and `Dendrite` class. If invoked from a
`Dendrite` instance, it is performed on the *active* page
### ask
Asks a question about the active page and processes the response based on the specified type.
**Usage**
```python theme={null}
class Conversation(BaseModel):
username: str
unread_messages: int
signed_in = browser.ask("Is this a signed in dashboard?", type_spec=bool)
if signed_in:
conversation = browser.ask(
"Which conversation has most unread emails", type_spec=Conversation
)
print(conversation.username)
```
**Arguments**
* `prompt` (str): The question or prompt to be asked.
* `type_spec` ([TypeSpec](/sdk-reference/python/types/type-spec), optional): The expected return type, which can be a type or a schema. Defaults to None.
**Returns**
[TypeSpec](/sdk-reference/python/types/type-spec) | Any: The response data as the specified type. Defaults to Any.
**Raises**
`DendriteException`: If the request fails, the exception includes the failure message and a screenshot.
This method exists on the `Page` and `Dendrite` class. If invoked from a
`Dendrite` instance, it is performed on the *active* page
### wait\_for
Waits for the condition specified in the prompt to become true by periodically checking the page content.
This method retrieves the page information and evaluates whether the specified condition (provided in the prompt) is met. It continues to retry until the total elapsed time exceeds the timeout.
**Usage**
```python theme={null}
try:
browser.wait_for("Loading to complete", timeout=10000)
# continue with page interactions
except PageConditionNotMet as e:
print(f"Condition was not met before timeout: {e.message}")
```
**Arguments**
* `prompt` (str): The prompt to determine the condition to wait for on the page.
* `timeout` (float, optional): The maximum time (in milliseconds) to wait for the condition. Defaults to 30000.
**Returns**
`True` if condition is met before timeout.
**Raises**
`PageConditionNotMet` if condition is not met before timeout
This method exists on the `Page` and `Dendrite` class. If invoked from a
`Dendrite` instance, it is performed on the *active* page
### press
Presses a keyboard key on the active page, optionally with modifier keys.
**Usage**
```python theme={null}
browser.fill("Search field", value="AI agents")
browser.press("Enter")
```
**Arguments**
* `key` (str): The main key to be pressed.
* `hold_shift` (bool, optional): Whether to hold the Shift key. Defaults to False.
* `hold_ctrl` (bool, optional): Whether to hold the Control key. Defaults to False.
* `hold_alt` (bool, optional): Whether to hold the Alt key. Defaults to False.
* `hold_cmd` (bool, optional): Whether to hold the Command key (Meta on some systems). Defaults to False.
**Returns**
`None`
**Raises**
`DendriteException` if key press fails
This method exists on the `Page` and `Dendrite` class. If invoked from a
`Dendrite` instance, it is performed on the *active* page
### upload\_files
Uploads files to the page using the file chooser.
**Usage**
```python theme={null}
browser.click("Upload file button")
browser.upload_files("path/to/file.png")
```
**Arguments**
* `files` (Union\[str, pathlib.Path, FilePayload, Sequence\[Union\[str, pathlib.Path]], Sequence\[FilePayload]]): The file(s) to be uploaded.
This can be a file path, a `FilePayload` object, or a sequence of file paths or `FilePayload` objects.
* `timeout` (float, optional): The maximum amount of time (in milliseconds) to wait for the file chooser to be ready. Defaults to 30000.
**Returns**
* `None`
This method exists on the `Page` and `Dendrite` class. If invoked from a
`Dendrite` instance, it is performed on the *active* page
### get\_download
Retrieves the most recent reference to a downloaded file. To actually save the file to the local machine, you need to invoke the `download.save_as` method on the object returned from `get_download`.
**Usage**
```python theme={null}
# Download the file and get a reference to it
browser.click("Download File")
download = browser.get_download(timeout=5000)
# Save the downloaded file to the suggested location
download_path = "path/to/file/" + download.suggested_filename
download.save_as(download_path)
```
**Arguments**
* `timeout` (float, optional): The maximum amount of time (in milliseconds) to wait for the download to complete. Defaults to 30000.
**Returns**
* `Download`
This method exists on the `Page` and `Dendrite` class. If invoked from a
`Dendrite` instance, it is performed on the *active* page
### get\_download
Retrieves the downloaded file data.
**Usage**
```python theme={null}
download = await page.get_download(timeout=60000)
```
**Arguments**
* `timeout` (float, optional): The maximum amount of time (in milliseconds) to wait for the download to complete. Defaults to 30000.
**Returns**
* The downloaded file data.
### scroll\_to\_bottom
Scrolls to the bottom of the page continuously until the bottom is reached or a timeout occurs.
**Usage**
```python theme={null}
await page.scroll_to_bottom(timeout=60000)
```
**Arguments**
* `timeout` (float, optional): The maximum amount of time (in milliseconds) to continue scrolling. Defaults to 30000.
### get\_element
Retrieves a single Dendrite element based on the provided prompt.
**Usage**
```python theme={null}
element = await page.get_element("The submit button")
```
**Arguments**
* `prompt` (str): The prompt describing the element to be retrieved.
* `use_cache` (bool, optional): Whether to use cached results. Defaults to True.
* `max_retries` (int, optional): The maximum number of retry attempts. Defaults to 3.
* `timeout` (int, optional): The timeout (in milliseconds) between retries. Defaults to 3000.
**Returns**
* DendriteElement: The retrieved element.
### get\_elements
Retrieves Dendrite elements based on either a string prompt or a dictionary of prompts.
**Usage**
```python theme={null}
elements = await page.get_elements("All input fields on the page")
```
**Arguments**
* `prompt_or_elements` (Union\[str, Dict\[str, str]]): The prompt or dictionary of prompts for element retrieval.
* `use_cache` (bool, optional): Whether to use cached results. Defaults to True.
* `max_retries` (int, optional): The maximum number of retry attempts. Defaults to 3.
* `timeout` (int, optional): The timeout (in milliseconds) between retries. Defaults to 3000.
* `context` (str, optional): Additional context for the retrieval. Defaults to an empty string.
**Returns**
* Union\[List\[DendriteElement], DendriteElementsResponse]: A list of elements or a response object containing the retrieved elements.
### upload\_files
Uploads files to the page using a file chooser.
**Usage**
```python theme={null}
await page.upload_files("path/to/file.txt", timeout=60000)
```
**Arguments**
* `files` (Union\[str, pathlib.Path, FilePayload, Sequence\[Union\[str, pathlib.Path]], Sequence\[FilePayload]]): The file(s) to be uploaded.
* `timeout` (float, optional): The maximum amount of time (in milliseconds) to wait for the file chooser to be ready. Defaults to 30000.
### get\_content
Retrieves the content of the current page.
**Usage**
```python theme={null}
content = await page.get_content()
```
**Returns**
* `str`: The HTML content of the current page.