82 lines
3.8 KiB
Markdown
82 lines
3.8 KiB
Markdown
---
|
|
name: chrome_launch
|
|
kind: function
|
|
lang: go
|
|
domain: browser
|
|
version: "1.1.0"
|
|
purity: impure
|
|
signature: "func ChromeLaunch(opts ChromeLaunchOpts) (int, error)"
|
|
description: "Lanza Google Chrome con remote debugging habilitado en el puerto indicado. Busca chrome.exe en PATH (WSL2) o en rutas conocidas de Windows. En WSL2+chrome.exe, traduce UserDataDir a ruta Windows via wslpath e inyecta --remote-debugging-address=0.0.0.0 automaticamente. Espera hasta 15s a que el puerto CDP este listo antes de retornar. Retorna el PID del proceso."
|
|
tags: [chrome, cdp, browser, automation, wsl2, headless, navegator]
|
|
uses_functions: []
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: [fmt, net, os, os/exec, regexp, strings, time]
|
|
params:
|
|
- name: opts
|
|
desc: "opciones de lanzamiento: Port (defecto 9222), UserDataDir (defecto /tmp/chrome-cdp-profile en Linux, C:\\Users\\<USER>\\AppData\\Local\\fn-chrome-cdp-profile en WSL2+exe), Headless, ChromePath, ExtraArgs"
|
|
output: "int: PID del proceso Chrome lanzado"
|
|
tested: true
|
|
tests: ["TestIsWSL2", "TestTranslateUserDataDirForWindows", "TestIsWindowsExe", "TestFindChrome", "TestChromeLaunchAndConnect"]
|
|
test_file_path: "functions/browser/chrome_launch_test.go"
|
|
file_path: "functions/browser/chrome_launch.go"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
// Linux nativo (sin WSL2 o con Linux Chrome)
|
|
pid, err := ChromeLaunch(ChromeLaunchOpts{
|
|
Port: 9222,
|
|
Headless: true,
|
|
})
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
defer CdpClose(nil, pid)
|
|
```
|
|
|
|
```go
|
|
// WSL2 → chrome.exe Windows: cero configuracion, todo automatico
|
|
// ChromeLaunch detecta WSL2+.exe, traduce user-data-dir y bind 0.0.0.0
|
|
pid, err := ChromeLaunch(ChromeLaunchOpts{})
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
// CDP listo en 127.0.0.1:9222 desde WSL2
|
|
conn, err := CdpConnect(9222)
|
|
```
|
|
|
|
## Cuando usarla
|
|
|
|
Cuando necesites lanzar Chrome con CDP desde Go para automatizacion (scraping, tests, capturas). Usar antes de `CdpConnect` / `CdpNavigate` / `CdpScreenshot`. Funciona tanto en Linux nativo como en WSL2 apuntando al chrome.exe de Windows.
|
|
|
|
## Gotchas
|
|
|
|
- **WSL2 + chrome.exe**: la funcion detecta automaticamente WSL2 (`/proc/version` contiene "microsoft"/"WSL") y que el ejecutable es `.exe`. En ese caso:
|
|
- `UserDataDir` vacio o con prefijo `/tmp/` o `/home/` se traduce via `wslpath -w` a ruta Windows. Por defecto: `C:\Users\<USER>\AppData\Local\fn-chrome-cdp-profile`.
|
|
- Se inyecta `--remote-debugging-address=0.0.0.0` para que Chrome sea accesible desde WSL2 vía `127.0.0.1:<port>`.
|
|
- `waitCDPReady` siempre espera usando `127.0.0.1` (WSL networking reenvía localhost → Windows).
|
|
- **`wslpath` debe estar disponible**: se invoca como subproceso. Si falla, `ChromeLaunch` retorna error. `wslpath` es estándar en WSL2 desde Windows 10 1903+.
|
|
- **Chrome no cierra solo**: el PID devuelto es el proceso Chrome. Usar `CdpClose(nil, pid)` o `os.FindProcess(pid).Kill()` para terminarlo.
|
|
- **Puerto ocupado**: si el puerto ya está en uso por otra instancia de Chrome, `waitCDPReady` puede conectar al proceso previo. Usar puertos distintos por sesión.
|
|
- **Headless en Windows via WSL2**: `--headless=new --disable-gpu` funciona bien con chrome.exe.
|
|
|
|
## Notas
|
|
|
|
Busca Chrome en este orden:
|
|
1. `chrome.exe` en PATH (disponible en WSL2 si Windows lo tiene en PATH)
|
|
2. `google-chrome` / `chromium-browser` / `chromium` (Linux nativo)
|
|
3. `/mnt/c/Program Files/Google/Chrome/Application/chrome.exe`
|
|
4. `/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe`
|
|
|
|
Los flags aplicados desactivan funcionalidades de red y actualizacion en segundo plano para entornos de automatizacion. En modo headless se agrega `--headless=new --disable-gpu`.
|
|
|
|
El struct `ChromeLaunchOpts` se define en el mismo archivo.
|
|
|
|
## Capability growth log
|
|
|
|
- v1.1.0 (2026-05-16) — auto-handle WSL2→Windows chrome.exe: translate user-data-dir via wslpath + inject --remote-debugging-address=0.0.0.0
|