Tabs

# Find first element with text
login_button = await tab.find("Login")

# Best match (most similar text length)
login_button = await tab.find("Login", best_match=True)

# Find all elements with text
all_links = await tab.find_all("Click here")

# Find single element
button = await tab.select("button[type='submit']")

# Find all matching elements
links = await tab.select_all("a[href]")

# Include elements in iframes
all_inputs = await tab.select_all("input", include_frames=True)

# Find elements by XPath
scripts = await tab.xpath('//script[not(@src)]')

# Case-insensitive text search
elements = await tab.xpath(
    '//text()[contains(translate(., "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz"), "search text")]'
)

# Wait for element by selector
element = await tab.wait_for(selector="#dynamic-content")

# Wait for element by text
element = await tab.wait_for(text="Loading complete")

# Custom timeout
element = await tab.wait_for(selector=".notification", timeout=30)

# Navigate current tab
await tab.get("https://example.com")

# Open in new tab
new_tab = await tab.get("https://example.com", new_tab=True)

# Open in new window
new_window = await tab.get("https://example.com", new_window=True)

# Evaluate and get result
page_title = await tab.evaluate("document.title")

# Wait for promise to resolve
result = await tab.evaluate(
    "fetch('https://api.example.com/data').then(r => r.json())",
    await_promise=True
)

# Get deep serialized value
deep_obj = await tab.evaluate(
    "window.someComplexObject",
    return_by_value=False
)

# Save screenshot to file
await tab.save_screenshot("page.jpg")

# Capture full page
await tab.save_screenshot("fullpage.png", format="png", full_page=True)

# Get base64 encoded data
base64_data = await tab.screenshot_b64(format="jpeg")

# Scroll down 50% of page
await tab.scroll_down(amount=50)

# Scroll up 25% of page
await tab.scroll_up(amount=25)

# Control scroll speed (pixels per second)
await tab.scroll_down(amount=100, speed=1200)

# Maximize window
await tab.maximize()

# Minimize window
await tab.minimize()

# Fullscreen
await tab.fullscreen()

# Normal state
await tab.medimize()

# Set download path first
import pathlib
await tab.set_download_path(pathlib.Path("./downloads"))

# Download file
await tab.download_file(
    "https://example.com/file.pdf",
    filename="document.pdf"
)

from zendriver.cdp.fetch import RequestStage
from zendriver.cdp.network import ResourceType

# Intercept and modify requests
async with tab.intercept(
    url_pattern="*api.example.com*",
    request_stage=RequestStage.REQUEST,
    resource_type=ResourceType.XHR
) as interceptor:
    async for request in interceptor:
        # Modify or block request
        await request.continue_()

# Wait for specific request
async with tab.expect_request(r".*api/data.*") as request:
    await button.click()
    
print(f"Request URL: {request.url}")

# Wait for response
async with tab.expect_response(r".*api/data.*") as response:
    await button.click()
    
print(f"Status: {response.status}")

from zendriver import cdp

# Send CDP command
result = await tab.send(
    cdp.page.navigate(url="https://example.com")
)

# Enable domain
await tab.send(cdp.network.enable())

# Call method with parameters
await tab.send(
    cdp.emulation.set_geolocation_override(
        latitude=37.7749,
        longitude=-122.4194,
        accuracy=100
    )
)