PrompteryxBeta
    ⌘K
    PlatformSupport
    Menu
    IntroductionInstall Desktop & extensionQuick StartPlatform Overview
    OverviewWhat you can makeAI Browser Agent in the chatModels and AutoConnectorsSchedulesProjectsExplore and publishingShare linksMemory and SkillsPersonal agent (beta)Welcome, settings and skinsPlans, credits and top-upsPrompteryx DesktopGroups (pilot)Phone app (early access)
    OverviewCreating WorkflowsTesting & DebuggingScheduling
    OverviewGetting StartedCommandsRecordingSettingsStructured OutputParallel AgentsTips & Best Practices
    OverviewInstallationSidebar AgentUsing Attached FilesExecute on Current TabExporting to Visual Studio
    Overview
    OverviewOpen PageClickClick CoordinatesFillExtract TextScreenshotWaitPress KeyFocus ElementBlur ElementSelect TextHighlight ElementSet ViewportGet Bounding BoxScrollHoverSelect OptionAssertionsCookiesEvaluate JavaScriptExample Workflows
    OverviewPrompteryx Browser AgentOpenAI
    OverviewSchedule TriggerWebhook Trigger
    OverviewGoogle SheetsGoogle CalendarConnect Hub (3,000+ apps)Example Workflows
    AI Vision SettingsChrome Automation ProfilesCloud BrowserBrowser Profiles & Persistent ContextVideo RecordingExecution LogsSharing & CollaborationEdit History
    Selectors GuideVariables
    Start hereGet an API keyRun the AI browser agentDrive a cloud browserRun workflows from anywhereUse connected apps (Connect Hub)SDK (TypeScript)CLIMCP for AI assistants
    REST APIWebhooksMCP toolsCloud Browser APICloud Browser quickstartMigrate from Browserbasen8nZapierMake.com

    Need help? Contact Support

    1. Documentation
    3. Nodes
    5. Browser Actions
    7. Wait

    Wait Nodes

    Browser Node

    Pause workflow execution until conditions are met

    Overview

    Wait nodes allow you to pause your workflow execution until certain conditions are met. This is essential for handling dynamic web pages, loading states, and asynchronous content. Prompteryx provides several types of wait functionality to cover different scenarios.

    Wait Types

    Wait for Element
    Wait until an element appears on the page
    Parameters
    Configuration options for this node
    Element Selector
    Selector Input
    Required

    The element to wait for. Use the crosshair button to pick visually, or enter a CSS selector.

    Example: .loading-complete, #results, getByRole('button', { name: 'Submit' })
    State
    Dropdown

    What element state to wait for: Visible (can be seen), Attached (in DOM), Hidden, or Detached.

    Default: Visible
    Timeout (ms)
    Number Input

    Maximum time to wait before giving up and failing the node.

    Default: 30000
    Wait (Timeout)
    Wait for a fixed duration
    Parameters
    Configuration options for this node
    Milliseconds
    Number Input
    Required

    How long to wait in milliseconds. Enter the number directly (e.g., 2000 for 2 seconds).

    Example: 2000 (2 seconds), 5000 (5 seconds)
    Prefer Conditional Waits
    Fixed timeouts should be avoided when possible. Use Wait for Element or Wait for URL instead, as they proceed as soon as the condition is met.
    Wait for Navigation
    Wait for a page navigation to complete
    Parameters
    Configuration options for this node
    waitUntil
    Select

    When to consider navigation complete

    Default: load
    timeout
    Number

    Maximum time to wait for navigation

    Default: 30000

    Wait Until Options:

    • load - Wait for the load event (default)
    • domcontentloaded - Wait for DOMContentLoaded event
    • networkidle - Wait until no network connections for 500ms
    Wait for URL
    Wait until the page URL matches a pattern
    Parameters
    Configuration options for this node
    urlPattern
    String
    Required

    A glob pattern with wildcards (e.g. **/dashboard), or plain text — plain text matches any URL that contains it

    Example: **/dashboard, https://example.com/*, /checkout/success
    timeout
    Number

    Maximum time to wait

    Default: 30000
    Wait for Function
    Wait until a JavaScript expression returns truthy
    Parameters
    Configuration options for this node
    JavaScript Expression
    JavaScript
    Required

    Expression that evaluates to truthy when the condition is met. No "return" keyword needed.

    Example: document.querySelectorAll('.item').length >= 10
    Polling Interval (ms)
    Number

    How often to check the condition in milliseconds

    Default: 100
    timeout
    Number

    Maximum time to wait

    Default: 30000
    Wait for Request / Wait for Response
    Wait for a network request to be made, or its response to arrive
    Parameters
    Configuration options for this node
    urlPattern
    String
    Required

    URL pattern to wait for (supports wildcards)

    Example: **/api/orders*, https://example.com/**
    timeout
    Number

    Maximum time to wait

    Default: 30000

    Usage Examples

    Example 1: Wait for Login Redirect
    Wait until redirected to dashboard after login
    Wait Type: Wait for URL
    URL Pattern:**/dashboard
    Timeout: 30000ms
    Example 2: Wait for Loading Spinner to Disappear
    Wait until a loading indicator is hidden
    Wait Type: Wait for Element
    Selector:.loading-spinner
    State: hidden
    Example 3: Wait for Minimum Items to Load
    Wait until at least 10 items are loaded
    Wait Type: Wait for Function
    JavaScript Expression:document.querySelectorAll('.list-item').length >= 10

    Best Practices

    Use Conditional Waits
    Always prefer conditional waits (Wait for Element, URL, or Function) over fixed timeouts. Conditional waits are faster and more reliable.
    Set Reasonable Timeouts
    Set timeouts that are long enough to handle slow networks but short enough to fail fast if something is wrong. 30 seconds is a good default.
    Wait for Hidden Elements
    Use state: "hidden" to wait for loading indicators, modals, or overlays to disappear before continuing with your workflow.

    Related Documentation

    Click Node

    Click on page elements

    Open Page Node

    Navigate to URLs

    Selectors Guide

    Master element selection

    Testing & Debugging

    Test your workflows