Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

Document autocomplete browser script helpers

Magnus Müller2ec5c8bd0f78
diff --git a/RUST_AGENT_INTEGRATION_FEATURES.md b/RUST_AGENT_INTEGRATION_FEATURES.md
index f1aa422ce..65b25780a 100644
--- a/RUST_AGENT_INTEGRATION_FEATURES.md
+++ b/RUST_AGENT_INTEGRATION_FEATURES.md
@@ -341,6 +341,11 @@ Terminal core branch: `magnus/browser-use-rust-integration` at latest pulled mai
- The helpers surface visible text fields, textareas, contenteditable fields, comboboxes, and textbox roles with labels/placeholders/selectors/rects, then fill a matched field by label, placeholder, name, selector, or nearby text through the existing real browser `fill_input` path.
- Proof: `browser_script_form_field_helpers_match_labels_and_fill_semantically`.
+67. Browser-script autocomplete helper
+ - Terminal browser scripts now expose `autocomplete_suggestions_snapshot(query=None, limit=20)` and `select_autocomplete(label_or_placeholder, query, match_text=None, timeout=3.0)`.
+ - The helpers score visible typeahead/listbox/menu suggestions using active-field `aria-controls`, roles, autocomplete/typeahead/dropdown classes, query text, rects, and centers, then fill the matched field and click the best visible suggestion.
+ - Proof: `browser_script_autocomplete_helpers_select_visible_suggestions`.
+
## Current Verification
- `python3 -m py_compile browser_use/rust/service.py browser_use/rust/__init__.py browser_use/__init__.py tests/ci/test_rust_agent.py examples/rust_agent/basic.py examples/rust_agent/real_v8_smoke.py`
@@ -385,6 +390,7 @@ Terminal core branch: `magnus/browser-use-rust-integration` at latest pulled mai
- `CARGO_INCREMENTAL=0 cargo test -q -p browser-use-browser browser_script_form_control_helpers_toggle_labeled_controls -- --nocapture`
- `CARGO_INCREMENTAL=0 cargo test -q -p browser-use-browser browser_script_select_helpers_choose_native_select_options -- --nocapture`
- `CARGO_INCREMENTAL=0 cargo test -q -p browser-use-browser browser_script_form_field_helpers_match_labels_and_fill_semantically -- --nocapture`
+- `CARGO_INCREMENTAL=0 cargo test -q -p browser-use-browser browser_script_autocomplete_helpers_select_visible_suggestions -- --nocapture`
- Managed-headless end-to-end:
- `BROWSER_USE_TERMINAL_BINARY=/home/exedev/Developer/terminal/target/debug/browser-use-terminal BROWSER_USE_RUST_BROWSER_MODE=managed-headless BU_TASK='Open https://example.com and report the page title only.' BU_MAX_STEPS=12 timeout 300 uv run python examples/rust_agent/basic.py`
- Output: `Example Domain`