Skip to content

Latest commit

 

History

History
102 lines (79 loc) · 2.7 KB

COMMANDS.md

File metadata and controls

102 lines (79 loc) · 2.7 KB

Commands

Each REPL line is one command. Commands can also be supplied with --cmd. Trinity Tool Contract input envelopes can be supplied with --input <path|- >.

Idempotency and retry safety are documented in IDEMPOTENCY.md.

Navigation

Command Example
goto <url> goto /dashboard
back back
reload reload

Read

Command Example
text <selector> text h1
html <selector> html #main
attrs <selector> attrs button.primary
exists <selector> exists .notice
eval <js> eval document.title
outline outline
buttons buttons
forms forms
table <selector> table table
snapshot snapshot

text <selector> normalizes whitespace by default: trailing whitespace is trimmed per line, and three-or-more newline runs collapse to one blank line. Use --clean=false globally or text <selector> @clean=false for legacy raw-ish text output.

snapshot includes no project-specific JavaScript globals by default. Add explicit names through config snapshot.globals when a private workflow needs to capture page globals.

Action

Command Example
click <selector> click button[type=submit]
fill <selector> <value> fill input[name=email] [email protected]
select <selector> <value> select select[name=role] admin
upload <selector> <path> upload input[type=file] ./file.pdf
screenshot [name] screenshot proof.png
viewport [WxH] viewport 375x667
set-viewport <WxH> set-viewport 1440x900

viewport without arguments reports the current viewport and browser screen metrics. With arguments, it changes the current page viewport immediately.

Supported forms:

viewport 375x667
viewport 768 1024
viewport mobile
viewport tablet
viewport desktop
viewport wide

Force

Force commands are high-risk and blocked unless policy allows them.

Command Example
force-click <selector> force-click button:disabled
force-fill <selector> <value> force-fill input[readonly] value
force-submit <selector> force-submit form
force-enable <selector> force-enable button
force-show <selector> force-show #hidden

Monitor

Command Example
monitor-ajax monitor-ajax
ajax-log ajax-log
monitor-console monitor-console
console-log console-log
wait-ajax wait-ajax

Session

Command Example
login [profile] login demo
cookies cookies
exit exit

Chain

Use ; to chain commands:

goto / ; exists h1 ; screenshot home.png