set

Purpose: Assign a value to a variable, load content from a file into a variable, or set the variable to the content of the Browser Bro text editor

set|~variableName|value or set|~variableName|file|path/to/file.txt or set|~variableName|text editor

set|~greeting|Hello there!
set|~config|file|config.txt
set|~prompts|text editor

get

Purpose: Retrieve the value from a DOM element and store it in a variable

get|ID|emailField|~userEmail
get|name|username|~userName
get|class|form-input|~inputValue
get|aria|Search Box|~searchTerm

ask

Purpose: Display a dialog box to prompt the user for input and store the response in a variable

ask|Please enter your username|~username
ask|What is your age?|~userAge
ask|Enter search term|~searchQuery

js

Purpose: Execute raw JavaScript code.

js|console.log('Hello world!');
js|document.title = 'New Title';
js|localStorage.setItem('key', 'value');

custom

Purpose: Execute a pre-defined custom JavaScript snippet with parameter substitution. Parameters replace placeholders like <<<BBSH_1>>>, <<<BBSH_2>>> etc.

custom|fillForm|John Doe|john@email.com|~password
custom|validateField|phoneNumber|~phoneVar

alert

Purpose: Display a browser alert dialog with static text or variable content.

alert|[Message] or alert|~variableName

alert|This is an alert message!
alert|Process completed successfully
alert|~myVariable
alert|~userMessage

Zoom

Purpose: Adjust the webpage zoom level. (1 = 100%, 0.5 = 50%, etc.)

Zoom|0.75
Zoom|1.5
Zoom|1

Go

Purpose: Navigate through browser history, load a new URL with optional parameters, or navigate to the Browser Bro Array.

• Go|Array – Navigate to the Browser Bro Array view
• Go|Forward – Go forward in history
• Go|Back – Go back in history
• Go|[URL] – Navigate to URL
• Go|[URL]|param|key1|value1|key2|value2 – URL with query parameters
• Go|[URL]|path|segment1|segment2 – URL with path segments

Go|Array
Go|https://www.example.com
Go|Forward
Go|Back
Go|https://api.example.com|param|apiKey|~myKey|format|json
Go|https://example.com|path|users|~userId|profile

Reload

Purpose: Refresh the current webpage.

Reload

Wait

Purpose: Pause the script execution for a specified time. Use this to let pages load and avoid hitting servers too quickly.

• Wait|[Number] – Wait for seconds (default)
• Wait|[Number]|Seconds/Minutes/Hours
• Wait|[min,max]|Seconds/Minutes/Hours – Random wait between min and max

Wait|5
Wait|5|Seconds
Wait|1|Minutes
Wait|3,6|Seconds  // Random wait between 3 and 6 seconds

Scroll

Purpose: Scroll the page up or down by pixels, or scroll to a specific element using CSS-style selectors.

• Scroll|Down|[pixels] – Scroll down by pixels
• Scroll|Up|[pixels] – Scroll up by pixels
• Scroll|#elementId – Scroll to element by ID
• Scroll|.elementClass – Scroll to element by class
• Scroll|[pixels] – Default down scrolling

Scroll|Down|500
Scroll|Up|300
Scroll|#header-section
Scroll|.footer-content
Scroll|400  // Default down scrolling

Type

Purpose: Type text into an element identified by ID, name, class, aria-label. You can also reference variables (e.g., ~myVar).

Type|ID|usernameField|TestUser
Type|name|passwordField|~myVar   // Using a variable
Type|aria|Search|Find this text
Type|ID.innerhtml|contentDiv|<h1>Hello World</h1>
Type|aria.innerhtml|Description Box|~htmlContent

Focus

Purpose: Set the focus on an element so it becomes active.

Focus|ID|usernameField
Focus|name|user_password
Focus|class|input-field
Focus|aria|Email Address

Click

Purpose: Simulate a mouse click on an element.

Click|ID|submitButton
Click|class|btn-primary
Click|aria|Close
Click|name|loginBtn

Select

Purpose: Choose an option from a dropdown select element.

Select|ID|countryDropdown|US
Select|name|languageSelector|fr
Select|class|form-select|option2
Select|aria|Choose State|CA

Press

Purpose: Simulate keyboard key presses on a specific element. Supports special keys and single characters.

Supported special keys: Enter, Escape, Space, Tab, ArrowUp, ArrowDown, ArrowLeft, ArrowRight, Backspace, Delete

Press|ID|searchField|Enter
Press|class|text-input|Escape
Press|name|username|a
Press|aria|Message Box|Space
Press|ID|textArea|Backspace

loop

Purpose: Create loops to repeat commands. Must be closed with loop|end.

• loop|[number] – Loop a specific number of times
• loop|each line|~sourceVar|~currentLineVar – Loop through lines
• loop|each item|~sourceVar|~currentItemVar – Loop through items
• loop|end – End the loop

// Loop 5 times
loop|5
Click|ID|likeButton
Wait|1|Seconds
loop|end

// Loop through each line
set|~names|file|names.txt
loop|each line|~names|~currentName
Type|ID|nameField|~currentName
Click|ID|submitBtn
Wait|2|Seconds
loop|end

// Loop through items
loop|each item|~itemList|~currentItem
js|console.log('Processing item: ~currentItem');
loop|end

shell

Purpose: Run a local shell command (synchronous execution)

shell|ls -la
shell|mkdir new_folder
shell|echo "Hello World"

asyncShell

Purpose: Run a local shell command asynchronously (non-blocking)

asyncShell|npm install
asyncShell|python long_running_script.py

Breakpoint

Purpose: Insert a debugging breakpoint to pause script execution for debugging

Type|ID|username|testuser
Breakpoint
Click|ID|submit

Snapshot

Purpose: Take a screenshot of the current browser view (Note: Not yet implemented)

Note: It is important to test which method of saving the page works best. In the Browser Array, you can use the ‘Test Screenshots’ method in the 3 dots menu of the browser # you want to test.