@ulpi/browse

Interaction

Click, fill, type, scroll, hover, drag, upload, and more

26 commands

click

browse click <selector>

Click element by CSS selector or @ref

Click by ref

$ browse click @e3
Clicked @e3

rightclick

browse rightclick <selector>

Right-click element (context menu)

Right-click

$ browse rightclick @e1

dblclick

browse dblclick <selector>

Double-click element

Double-click

$ browse dblclick @e2

fill

browse fill <selector> <value>

Clear and fill input field

Fill email field

$ browse fill @e4 "user@example.com"
Filled @e4

select

browse select <selector> <value>

Select dropdown option

Select option

$ browse select @e5 "us"

hover

browse hover <selector>

Hover over element

Hover

$ browse hover @e1

focus

browse focus <selector>

Focus element

Focus input

$ browse focus @e3

tap

browse tap <selector>

Tap element (requires touch context via emulate)

Tap button

$ browse tap @e2

check

browse check <selector>

Check checkbox

Check checkbox

$ browse check @e7

uncheck

browse uncheck <selector>

Uncheck checkbox

Uncheck

$ browse uncheck @e7

type

browse type <text>

Type text via keyboard into focused element

Type text

$ browse type "Hello world"

press

browse press <key>

Press key (Enter, Tab, Escape, etc.)

Press Enter

$ browse press Enter

keydown

browse keydown <key>

Hold key down

Hold Shift

$ browse keydown Shift

keyup

browse keyup <key>

Release key

Release Shift

$ browse keyup Shift

scroll

browse scroll [selector|up|down]

Scroll element into view or scroll direction

Scroll down

$ browse scroll down

scrollinto

browse scrollinto <selector>

Scroll element into view (explicit)

Scroll to element

$ browse scrollinto @e10

drag

browse drag <source> <target>

Drag and drop between elements

Drag item

$ browse drag @e1 @e5

highlight

browse highlight <selector>

Highlight element with visual overlay

Highlight element

$ browse highlight @e3

download

browse download <selector> [path]

Download file triggered by click

Download file

$ browse download @e8 ./report.pdf

upload

browse upload <selector> <files...>

Upload files to file input

Upload file

$ browse upload @e4 ./photo.jpg

wait

browse wait <selector|ms|--flag>

Wait for element, URL, text, network idle, or timeout

Flags

--urlWait for URL pattern
--textWait for text to appear
--network-idleWait for network idle
--downloadWait for download

Wait for network

$ browse wait --network-idle

swipe

browse swipe <direction> [px]

Swipe up/down/left/right (touch events)

Swipe down

$ browse swipe down 300

mouse

browse mouse <action> [args]

Low-level mouse control: move, click, down, up, wheel

Move mouse

$ browse mouse move 100 200

Mouse wheel

$ browse mouse wheel 300

keyboard

browse keyboard inserttext <text>

Insert text without triggering key events

Insert text

$ browse keyboard inserttext "Hello"

dialog-accept

browse dialog-accept [text]

Auto-accept next browser dialog (alert, confirm, prompt)

Accept dialog

$ browse dialog-accept

Accept with text

$ browse dialog-accept "my input"

dialog-dismiss

browse dialog-dismiss

Auto-dismiss next browser dialog

Dismiss dialog

$ browse dialog-dismiss

On this page