browser-use--browser-harness
Sarath Suresh
fbd9146df5
- goto() → goto_url() - click() → click_at_xy() - screenshot() → capture_screenshot() These three shared exact names with Playwright but different argument shapes, causing agent confusion. Updated helpers.py and all markdown skill files. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
48 行
1.6 KiB
Markdown
48 行
1.6 KiB
Markdown
# Connection & Tab Visibility
|
|
|
|
## The omnibox popup problem
|
|
|
|
When Chrome opens fresh, the only CDP `type: "page"` targets are `chrome://inspect` and `chrome://omnibox-popup.top-chrome/` (a 1px invisible viewport). If the daemon attaches to the omnibox popup, all subsequent work — including `new_tab()` and `goto_url()` — happens on tabs that exist in CDP but may not be visible in the Chrome UI.
|
|
|
|
The daemon's `attach_first_page()` handles this by creating an `about:blank` tab when no real pages exist. If you still end up on an invisible tab, use `switch_tab()` which calls `Target.activateTarget` to bring the tab to front.
|
|
|
|
## Startup sequence
|
|
|
|
1. Check if a daemon is already running with `daemon_alive()`
|
|
2. If stale sockets exist but daemon is dead, clean them up
|
|
3. List open tabs with `list_tabs()` to see what's available
|
|
4. `ensure_real_tab()` attaches to a real page
|
|
5. `switch_tab(target_id)` both attaches AND activates (brings to front)
|
|
|
|
```python
|
|
if not daemon_alive():
|
|
import os
|
|
for f in ["/tmp/bu-default.sock", "/tmp/bu-default.pid"]:
|
|
if os.path.exists(f): os.unlink(f)
|
|
ensure_daemon()
|
|
|
|
tabs = list_tabs()
|
|
for t in tabs:
|
|
print(t["url"][:60])
|
|
|
|
tab = ensure_real_tab()
|
|
```
|
|
|
|
## Bringing Chrome to front
|
|
|
|
If Chrome is behind other windows or on another desktop:
|
|
|
|
```python
|
|
import subprocess
|
|
subprocess.run(["osascript", "-e", 'tell application "Google Chrome" to activate'])
|
|
```
|
|
|
|
## Navigating
|
|
|
|
Prefer navigating an existing tab over `new_tab()`. Tabs created via CDP's `Target.createTarget` are visible but may open behind the active tab.
|
|
|
|
```python
|
|
tab = ensure_real_tab()
|
|
goto_url("https://example.com")
|
|
```
|