Navigate

Navigate

Type: page-navigate  ·  Package: Browser v1.0.9

Navigates the current page to a URL. Use it to go to an address after opening the browser, or to move between pages during the flow (for example, open a record’s detail, go back to the list, move to the next section).

How it works

It loads the given URL in the page session and waits for loading to reach the point defined in waitUntil before continuing. If the page takes longer than timeout, the activity fails.

• The URL must be complete, including its scheme (https://…).
• An error response from the server (404, 500) does not make the activity fail: the error page loads like any other. Check it afterwards with Element Exists or Get Text.
• If the server doesn’t respond, the domain doesn’t exist or there’s no network, it fails with the browser’s network error.

Required parameters

Parameter	Type	Default	Description
url	string	—	The URL to navigate to. E.g. https://example.com. Supports expressions.

Optional parameters

Parameter	Type	Default	Description
page	ZoanPageSession	—	The page session. Omit it inside a body; outside, pass the session variable (e.g. page = page).
waitUntil	string	"load"	When to consider navigation done: load (full load, with images and styles) · domcontentloaded (HTML ready) · networkidle (no network traffic for 500 ms) · commit (as soon as the server responds).
timeout	number	30000	Maximum time in ms. Empty, 0 or negative: the project settings value or, if none, 30000.

Output

This activity does not return a value.

Example

Open Browser   browser = chrome   → output: page
Page Navigate  page = page   url = "https://erp.example.com/invoice/" + numeroFactura
Page Wait For  page = page   selector = (#detalleFactura)   state = visible

waitUntil for modern pages

On sites that load content with JavaScript after the initial HTML, load may declare navigation finished before what you’re looking for appears. If that happens, combine it with a Wait For on a key element, or use networkidle (stricter, but slower).

Common errors

Message	Cause and fix
'url' is required.	url is empty.
Cannot navigate to invalid URL	The scheme (https://) is missing or the URL is malformed.
net::ERR_NAME_NOT_RESOLVED / net::ERR_CONNECTION_REFUSED	The domain doesn’t exist, there’s no network or the server refuses connections. Check the URL and the machine’s connection; for intermittent failures, wrap it in Retry.
Timeout 30000ms exceeded	The page didn’t reach waitUntil in time. Raise timeout or use a less demanding waitUntil (domcontentloaded) followed by a Wait For.
'page' must be a ZoanPageSession.	page is empty outside a body.

Related activities

• Open Browser — also accepts an initial url on open.
• Wait For — wait for the content to be ready after navigating.