dym-browser-use-repl

dym-browser-use-repl

When to use

• Việc cần nhiều bước có điều kiện — bước sau phụ thuộc thứ nhìn thấy ở bước trước. Script Playwright buộc phải viết mù toàn bộ kịch bản trước khi chạy; sai một chỗ là chạy lại từ đầu, mất cả login lẫn state.
• Đã viết .mjs verify 2–3 lần mà vẫn trượt phần tử → đổi sang REPL, xem trang thật rồi mới quyết.
• Cần chạm file:// hoặc localhost (claude-in-chrome chặn 2 scheme này).

KHÔNG dùng khi: chỉ cần chụp một ảnh, hoặc chỉ đọc console một lần. Đó là việc của /playwright-verify — một file .mjs, một lần chạy, xong vứt. Rẻ hơn.

Số đo (máy user, 09/09/2026, cùng một trang file://)

Steps

1. Cài một lần (yêu cầu Python ≥ 3.11 — python3 mặc định của macOS là 3.9.6, sẽ trượt):

   python3.13 -m venv ~/.bh-venv && ~/.bh-venv/bin/pip install \
     "git+https://github.com/browser-use/browser-harness"
   ~/.bh-venv/bin/browser-harness --version   # 0.1.13 (đo 09/2026)
   

2. Chuẩn bị một Chrome có CDP — KHÔNG mượn Chrome của user (macOS sẽ bật hộp thoại xin phép remote-debugging và chiếm tab đang làm việc). Dựng riêng một Chrome for Testing:

   CH="$HOME/Library/Caches/ms-playwright/chromium-1243/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing"
   "$CH" --remote-debugging-port=9333 --user-data-dir=/tmp/bh-prof --headless=new --no-first-run about:blank &
   

   Chưa có binary → npx playwright install chromium (dùng chung cache ~/Library/Caches/ms-playwright).
3. Mỗi hành động = một heredoc. Helper đã import sẵn, daemon tự bám vào tab cũ:

   export BH="HOME=/tmp/bhh BU_CDP_URL=http://localhost:9333 $HOME/.bh-venv/bin/browser-harness"
   
   env $BH <<'PY'
   new_tab("http://localhost:3000/checkout")   # lượt ĐẦU dùng new_tab, không phải goto_url
   wait_for_load()
   print(page_info())
   PY
   
   env $BH <<'PY'
   print(js("[...document.querySelectorAll('button')].map(b=>b.innerText)"))
   PY
   

4. Bấm bằng toạ độ đọc từ DOM, không từ pixel ảnh đã co:

   r = js("document.querySelector('#submit').getBoundingClientRect()")
   click_at_xy(r["x"] + r["width"]/2, r["y"] + r["height"]/2)
   

5. Sau mỗi bước, moi lỗi ảnh chụp không thấy:

   errs = [e for e in drain_events() if e["method"] == "Runtime.exceptionThrown"
           or (e["method"] == "Runtime.consoleAPICalled" and e["params"].get("type") == "error")
           or e["method"] == "Network.loadingFailed"
           or (e["method"] == "Network.responseReceived" and e["params"]["response"]["status"] >= 400)]
   

6. Dọn: pkill -f "remote-debugging-port=9333".