Skip to navigation

Browser surface

Referenced In

Fields

FieldTypeDescriptionDefault
browserstringRequired. Browser engine. Selects the browser surface with that engine (or the one named by name). A goTo step opens the browser if it isn’t open yet — you can also open one explicitly with startSurface; other steps require it to already be open.

Accepted values: chrome, firefox, safari, webkit, edge
—
namestringOptional. Name of the browser surface. Defaults to the engine name (the context’s default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.

Minimum length: 1. Pattern: \S
—
windowone of:
- integer
- string
- object(By criteria)
Optional. Which window to act on. Omit to use the active window.—
tabone of:
- integer
- string
- object(By criteria)
Optional. Which tab to act on. Omit to use the active tab. Without window, the selector searches every tab in creation order — including tabs the page opened itself.—

Examples

{
"browser": "chrome",
"name": "example",
"window": 42,
"tab": 42
}