click_until_exhausted

Repeatedly click a button until no new content appears or max clicks reached. This function is useful for “Load More” buttons or paginated content where you need to keep clicking until all content is loaded. It provides several stopping conditions:

Button becomes invisible/disabled
Maximum number of clicks reached
No change detected in container content (when container_locator is provided)

async def click_until_exhausted(
    page: Page,
    button_locator: Locator,
    heartbeat: Callable[[], None],
    *,
    container_locator: Locator | None,
    max_clicks: int,
    click_delay: float,
    no_change_threshold: int,
)

Examples

from typing import TypedDict
from playwright.async_api import Page
from intuned_browser import click_until_exhausted
class Params(TypedDict):
    pass
async def automation(page: Page, params: Params, **_kwargs):
    await page.goto("https://sandbox.intuned.dev/load-more")
    load_more_button = page.locator("main main button")  # Select the main button in the main content area.
    # Click until button disappears or is disabled
    await click_until_exhausted(
        page=page,
        button_locator=load_more_button,
        max_clicks=20
    )
    # Will keep clicking the button until the button disappears or is disabled or the max_clicks is reached.

from typing import TypedDict
from playwright.async_api import Page
from intuned_browser import click_until_exhausted
class Params(TypedDict):
    pass
async def automation(page: Page, params: Params, **_kwargs):
    await page.goto("https://sandbox.intuned.dev/load-more")
    load_more_button = page.locator("aside button")  # Select the button in the sidebar.
    container = page.locator('xpath=//*[@id="root"]/div[1]/main/slot/div/aside/div/div/slot/slot')  # Watch the sidebar container to detect changes.
    # This will count the elements under the container given before each click and after, if the count is the same, the function will stop.
    click_count = 0
    def heartbeat_callback():
        nonlocal click_count
        click_count += 1
        print(f"Clicked {click_count} times")
    await click_until_exhausted(
        page=page,
        button_locator=load_more_button,
        container_locator=container,
        heartbeat=heartbeat_callback,
        max_clicks=30,
        click_delay=0.5,
        no_change_threshold=0
    )
    # Will keep clicking the button until the button disappears or is disabled or the max_clicks is reached or no more content is loaded.

Arguments

page

Page

required

Playwright Page object

button_locator

Locator

required

Locator for the button to click repeatedly

heartbeat

Callable[[], None]

Optional callback invoked after each click. Defaults to lambda: None.

container_locator

Locator

Optional content container to detect changes. Defaults to None.

max_clicks

int

Maximum number of times to click the button. Defaults to 50.

click_delay

float

Delay after each click (in seconds). Defaults to 0.5.

no_change_threshold

int

Minimum change in content size to continue clicking. Defaults to 0.

Returns: `None`

Function completes when clicking is exhausted

Introduction

Typescript SDK

Python SDK

click_until_exhausted

Examples

Arguments

Returns: `None`

​Examples

​Arguments

​Returns: None

Examples

Arguments

Returns: `None`