Browser blocks
Open pages, find elements, click, type and read content.
Browser Run
Opens a browser profile at a page. Visible mode shows a real window; headless mode runs it invisibly in the background.
In: Profile:String, URL:String, Headless:Bool, Wait For Load:Bool, Timeout:Int
Out: Window:Window, Success:Bool
Pro. Every profile keeps its own logins, so two profiles can be signed into two different accounts.
Browser Run(work, example.com) → Browser Find Element.
Browser Navigate
Sends an already-open browser to another address.
In: Window:Window, URL:String, Wait For Load:Bool
Out: Success:Bool
Pro. Cheaper than closing and reopening the browser.
Browser Navigate(win, example.com/login).
Browser Find Element
Finds something on the page and tells you where it sits on screen. Use the Inspector in the Browser panel to get the address of an element by clicking it.
In: Window:Window, Selector:String
Out: Found:Bool, Pos:Vec2, Size:Vec2
Pro. Feed Pos into Mouse Move And Click for a real, physical click.
Find Element(.login-btn) → Mouse Move And Click(Pos).
Browser Text Of
Reads the text of an element straight from the page.
In: Window:Window, Selector:String
Out: Text:String, Found:Bool
Pro. Always prefer this over reading text off a screenshot — it is exact and does not care about fonts or zoom.
Text Of(.price) → OCR Text To Number → Compare.
Browser Image Of
Takes a picture of one element on the page and saves it as an image.
In: Window:Window, Selector:String, Index:Int, Save Path:String
Out: Image:Image, Count:Int, Success:Bool
Pro. Handy for captchas, charts and anything drawn rather than written as text.
Image Of(.captcha) → OCR Detect.
Browser Click
Clicks an element from inside the browser. Works even when the window is hidden or minimised.
In: Window:Window, Selector:String
Out: Success:Bool
Pro. This is a synthetic click, not a real mouse. A site can tell the difference — use a real mouse click when that matters.
Browser Click(.submit).
Browser Type
Types text into a field on the page, optionally clearing it first.
In: Window:Window, Selector:String, Text:String, Clear First:Bool
Out: Success:Bool
Pro. Notifies the page properly, so modern sites react as if a person typed.
Browser Type(#login, my_name).
Browser WaitFor
Waits until an element appears on the page — or until it disappears.
In: Window:Window, Selector:String, Should Exist:Bool, Timeout:Int
Out: Found:Bool
Pro. The right way to handle pages that load their content in stages.
WaitFor(.results, timeout 10s) → Text Of(.results).
Browser Eval JS
Runs your own snippet of code on the page and returns the result.
In: Window:Window, Code:String
Out: Result:String, Success:Bool
Pro. The escape hatch for anything the other blocks cannot reach. Only run code you wrote or trust.
Eval JS(return document.title) → Text.
Browser Close
Closes the browser session. Safe to call twice.
In: Window:Window
Out: Success:Bool
Pro. Put it at the end of a scenario so profiles do not pile up.
Browser Close(win).