Elements

34 tools in this group.

browser_find

Find an element and return its info (tag, text, bounding box). Use a CSS selector or a semantic locator (role, text, label, placeholder, testid, xpath, alt, title). Combine role with text or other locators to narrow results.

browser_find_all

Find all elements matching a CSS selector and return their info (tag, text, bounding box)

browser_map

Map interactive page elements with @refs for targeting. Returns a list of interactive elements (buttons, links, inputs, etc.) each with a short @ref like @e1, @e2. Use these refs as selectors in other commands (click, fill, etc.).

browser_get_attribute

Get the value of an HTML attribute on an element

browser_get_value

Get the current value of an input, textarea, or select element

browser_count

Count the number of elements matching a CSS selector

browser_is_visible

Check if an element is visible on the page. Returns true/false; an element that does not exist is false. Errors only when the check itself cannot run (invalid selector, lost browser connection).

browser_is_enabled

Check if an element is enabled (not disabled). Returns true/false.

browser_is_checked

Check if a checkbox or radio button is checked. Returns true/false.

browser_expect

Assert a condition about the current page (URL, title, text, element state, count, or a JS expression). Returns a PASS message when the assertion holds; fails with the actual value otherwise. Use this to verify a browser flow reached the expected state.

browser_click

Click an element by CSS selector. Waits for element to be visible, stable, and enabled.

browser_dblclick

Double-click an element by CSS selector or @ref

browser_hover

Hover over an element by CSS selector

browser_type

Type text into an element by CSS selector. Waits for element to be visible, stable, enabled, and editable.

browser_fill

Clear an input field and type new text. Waits for element to be editable, clears existing value, then types. Use this instead of browser_type when you want to replace the field contents.

browser_press

Press a key or key combination on a specific element or the focused element. If selector is given, clicks the element first to focus it, then presses the key.

browser_keys

Press a key or key combination (e.g., "Enter", "Control+a", "Shift+Tab")

browser_keyboard_type

Type text at the current focus, generating real key events. No selector — acts on the focused element.

browser_keyboard_inserttext

Insert text at the current focus WITHOUT synthesizing key events (IME/paste-like). No selector.

browser_keydown

Press and hold a key without releasing it (pair with browser_keyup for held-modifier sequences).

browser_keyup

Release a held key (pair with browser_keydown).

browser_select

Select an option in a <select> element by value

browser_check

Check a checkbox or radio button. Idempotent — does nothing if already checked.

browser_uncheck

Uncheck a checkbox. Idempotent — does nothing if already unchecked.

browser_focus

Focus an element by CSS selector or @ref

browser_scroll

Scroll the page or a specific element

browser_scroll_into_view

Scroll an element into view, centering it on screen

browser_mouse_click

Click at coordinates or at the current mouse position. If x and y are provided, moves the mouse there first.

browser_mouse_move

Move the mouse to specific coordinates

browser_mouse_down

Press a mouse button down at the current position

browser_mouse_up

Release a mouse button at the current position

browser_drag

Drag from one element to another

browser_upload

Set files on an input[type=file] element

browser_highlight

Highlight an element with a red outline for 3 seconds. Useful for visual debugging.