perf(browser): acelera CDP — enable cacheado, wait_load por evento, timeout en sendCDP, escritura insertText

Optimiza el dominio browser para que el manejo del navegador via CDP sea mucho más rápido en automatización propia, manteniendo el camino sigiloso disponible.

- CDPConn cachea los enable de Accessibility/Network/Page por conexión (ensureAX/ensureNetwork/ensurePage): elimina un round-trip redundante en cada percepción y espera, que son las operaciones más frecuentes del bucle percibir->actuar del agente.
- sendCDP adquiere timeout (cdpCmdTimeout 30s): antes una respuesta que Chrome nunca enviaba colgaba la goroutine del tool indefinidamente; ahora falla limpio y el retry puede reconectar.
- CdpWaitLoad pasa de polling de document.readyState cada 200ms a esperar el evento Page.loadEventFired, con fast path inicial de readyState y re-chequeo anti-carrera tras suscribir. Si la página ya está cargada retorna en microsegundos.
- cdp_wait_idle usa ensureNetwork y deja de hacer Network.disable al salir (borraba el estado y forzaba el enable de nuevo).
- Nuevas funciones de escritura rápida: CdpInsertText (todo el texto en un solo Input.insertText) y CdpTypeRefFast (focus + insertText). El chequeo de foco se extrajo a assertEditableFocus, compartido con CdpTypeText.
- CdpTypeText pasa su pausa entre caracteres de 10ms fija a aleatoria 15-65ms (ritmo humano irregular).
- El modo 'auto' se añade al perfil de ratón (MouseProfileForMode, mouseHumanDefaults, clickPauseMs) como alias rápido de 'fast'.

No se tocan las firmas públicas existentes; CdpTypeRef y CdpTypeText conservan su comportamiento (camino human).
This commit is contained in:
2026-06-13 14:27:10 +02:00
parent 167a7e5eb7
commit 216cad4c12
8 changed files with 183 additions and 50 deletions
+34 -16
View File
@@ -6,9 +6,11 @@ import (
)
// CdpWaitLoad espera a que la página actual termine de cargar completamente.
// Hace polling de document.readyState via Runtime.evaluate cada 200ms hasta
// que sea "complete", o hasta que se agote el timeout.
// Retorna error si el timeout se agota o si CdpEvaluate falla (conexion rota).
// Bloquea hasta recibir el evento CDP Page.loadEventFired (sin polling): suscribe
// el evento via OnEvent y espera en un canal con timeout. Antes de esperar hace un
// fast path comprobando document.readyState — si la página ya está "complete",
// retorna de inmediato sin armar el handler.
// Retorna error si el timeout se agota o si no logra habilitar el dominio Page.
func CdpWaitLoad(c *CDPConn, timeout time.Duration) error {
if c == nil {
return fmt.Errorf("cdp wait load: conexion nula")
@@ -17,19 +19,35 @@ func CdpWaitLoad(c *CDPConn, timeout time.Duration) error {
timeout = 30 * time.Second
}
deadline := time.Now().Add(timeout)
interval := 200 * time.Millisecond
for time.Now().Before(deadline) {
result, err := CdpEvaluate(c, "document.readyState")
if err != nil {
return fmt.Errorf("cdp wait load: error evaluando readyState: %w", err)
}
if result == "complete" {
return nil
}
time.Sleep(interval)
// Fast path: si el documento ya terminó de cargar, no esperamos eventos.
if rs, err := CdpEvaluate(c, "document.readyState"); err == nil && rs == "complete" {
return nil
}
return fmt.Errorf("cdp wait load: pagina no cargo despues de %s", timeout)
// Habilitar Page (idempotente, cacheado) y suscribir el evento de carga.
if err := c.ensurePage(); err != nil {
return fmt.Errorf("cdp wait load: Page.enable: %w", err)
}
loaded := make(chan struct{}, 1)
cancel := c.OnEvent("Page.loadEventFired", func(_ string, _ map[string]any) {
select {
case loaded <- struct{}{}:
default:
}
})
defer cancel()
// Re-chequear readyState tras suscribir: si la carga terminó entre el fast
// path y el registro del handler, ya no llegaría el evento (carrera) — lo
// captamos aquí en vez de colgarnos hasta el timeout.
if rs, err := CdpEvaluate(c, "document.readyState"); err == nil && rs == "complete" {
return nil
}
select {
case <-loaded:
return nil
case <-time.After(timeout):
return fmt.Errorf("cdp wait load: pagina no cargo despues de %s", timeout)
}
}