go_to_url

This function has multiple overloads

Without AI Loading Detection
With AI Loading Detection

Navigates to a specified URL with enhanced reliability features including automatic retries with exponential backoff, intelligent timeout handling, and optional AI-powered loading verification.This function handles common navigation challenges by automatically retrying failed requests, detecting navigation hangs, and ensuring the page reaches a truly idle state.

async def go_to_url(
    page: Page,
    url: str,
    *,
    timeout_s: int,
    retries: int,
    wait_for_load_state: str,
    throw_on_timeout: bool,
    wait_for_load_using_ai: Literal[False],
) -> None

Use this overload for standard navigation without AI-powered loading detection.

Examples

from typing import TypedDict
from playwright.async_api import Page
from intuned_browser import go_to_url
class Params(TypedDict):
    pass
async def automation(page: Page, params: Params, **_kwargs):
    await go_to_url(
        page,
        url='https://sandbox.intuned.dev/'
    )
    # At this point, go_to_url has waited for the page to be loaded and the network requests to be settled.

from typing import TypedDict
from playwright.async_api import Page
from intuned_browser import go_to_url
class Params(TypedDict):
    pass
async def automation(page: Page, params: Params, **_kwargs):
    await go_to_url(
        page,
        url='https://intunedhq.com',
        wait_for_load_state="domcontentloaded",  # Faster than "load" state. The function automatically waits for the page to settle.
        throw_on_timeout=True,
        timeout_s=10,
        retries=3
    )
    # At this point, DOM content is loaded and go_to_url has waited for network requests to settle.

Arguments

page

Page

required

The Playwright Page object to navigate.

url

str

required

The URL to navigate to.

timeout_s

int

Maximum navigation time in seconds. Defaults to 30.

retries

int

Number of retry attempts with exponential backoff (factor: 2). Defaults to 3.

wait_for_load_state

Literal['load', 'domcontentloaded', 'networkidle', 'commit']

When to consider navigation succeeded. Defaults to “load”.

throw_on_timeout

bool

Whether to raise an error on navigation timeout. When False, the function returns without throwing, allowing continued execution. Defaults to False.

wait_for_load_using_ai

bool

Set to False to disable AI-powered loading checks. Defaults to False.

async def go_to_url(
    page: Page,
    url: str,
    *,
    timeout_s: int,
    retries: int,
    wait_for_load_state: str,
    throw_on_timeout: bool,
    wait_for_load_using_ai: Literal[True],
    model: str | None,
    api_key: str | None,
) -> None

Use this overload when you need AI vision to verify the page is fully loaded by checking for loading spinners, blank content, or incomplete states.

Examples

from typing import TypedDict
from playwright.async_api import Page
from intuned_browser import go_to_url
class Params(TypedDict):
    pass
async def automation(page: Page, params: Params, **_kwargs):
    await go_to_url(
        page,
        url='https://intunedhq.com',
        wait_for_load_using_ai=True,
        model="gpt-5.4-mini"
    )
    # The page is loaded and ready to use.
    # If the AI check fails, the method won't throw even if throw_on_timeout is true.
    # It only throws if the page times out reaching the default load state and throw_on_timeout is true.

Arguments

page

Page

required

The Playwright Page object to navigate.

url

str

required

The URL to navigate to.

timeout_s

int

Maximum navigation time in seconds. Defaults to 30.

retries

int

Number of retry attempts with exponential backoff (factor: 2). Defaults to 3.

wait_for_load_state

Literal['load', 'domcontentloaded', 'networkidle', 'commit']

When to consider navigation succeeded. Defaults to “load”.

throw_on_timeout

bool

Whether to raise an error on navigation timeout. When False, the function returns without throwing, allowing continued execution. Defaults to False.

wait_for_load_using_ai

Literal[True]

required

Must be set to True to use this AI-powered overload. When true, uses AI vision to verify the page is fully loaded by checking for loading spinners, blank content, or incomplete states. Retries up to 3 times with 5-second delays. Check is_page_loaded for more details on the AI loading verification.

model

str

AI model to use for loading verification. Defaults to “gpt-5-mini-2025-08-07”.

api_key

str

Optional API key for the AI check. Defaults to None.

Returns: `None`

Function completes when navigation is finished or fails after retries.

Introduction

Typescript SDK

Python SDK

Examples

Arguments

Examples

Arguments

Returns: `None`

​Examples

​Arguments

​Examples

​Arguments

​Returns: None

Examples

Arguments

Examples

Arguments

Returns: `None`