Back to docs

Tool Navigate

Category: Browser Automation · Tier: All

Navigate to a URL and take a screenshot. Pass _browserToken from a previous call to reuse the same browser.

When to Use

Browser automation tools map to human motor interaction research. Click accuracy, form filling speed, and scroll behavior follow HCI models.

Parameters

Parameter Type Required Description
url string Yes The URL to navigate to
waitAfterLoad number No Extra ms to wait after page load. Use for i18n or deferred rendering (3000-5000).
waitForSelector string No CSS selector to wait for after load. Example: [data-translated]. Times out after 10s.

Example

Navigate to our staging site to check the new deployment
Navigate to the French version and wait for translation to finish
→ url: "https://example.com/fr", waitAfterLoad: 4000
Navigate and wait for dynamic content
→ url: "https://example.com", waitForSelector: "#app:not(:empty)"

Tips

  • Pass _browserToken from a previous tool call to maintain the same browser session
  • The tool returns a _browserToken in its response — pass it to subsequent calls
  • Without _browserToken, each call gets a fresh browser (blank page)
  • Use waitAfterLoad for client-side translation (Google Translate, Tolgee, i18next)
  • Use waitForSelector for SPAs that render after JS hydration

Research

Related

From the Blog