Files
fn_registry/functions/browser/cdp_wait_element.md
T
egutierrez 988e901066 docs: params/output semántico en 506 funciones para composabilidad
Añade campos params y output al frontmatter YAML de las 506 funciones del registry.
Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico)
y cada función describe qué produce su output. Permite a agentes razonar sobre
cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.
2026-04-05 18:45:16 +02:00

46 lines
1.5 KiB
Markdown

---
name: cdp_wait_element
kind: function
lang: go
domain: browser
version: "1.0.0"
purity: impure
signature: "func CdpWaitElement(c *CDPConn, selector string, timeout time.Duration) error"
description: "Espera hasta que un selector CSS exista en el DOM. Hace polling con Runtime.evaluate cada 200ms. Retorna nil cuando el elemento aparece o error si se agota el timeout. Util despues de navegacion o acciones que producen cambios dinamicos."
tags: [chrome, cdp, browser, automation, dom, wait, polling, devtools]
uses_functions: [cdp_connect_go_browser, cdp_evaluate_go_browser]
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [fmt, time]
params:
- name: c
desc: "conexión CDP activa"
- name: selector
desc: "selector CSS del elemento a esperar"
- name: timeout
desc: "duración máxima de espera"
output: "error si el elemento no aparece antes del timeout"
tested: false
tests: []
test_file_path: ""
file_path: "functions/browser/cdp_wait_element.go"
---
## Ejemplo
```go
conn, _ := CdpConnect(9222)
CdpNavigate(conn, "https://example.com")
// Esperar hasta 10 segundos a que aparezca el contenido
if err := CdpWaitElement(conn, ".main-content", 10*time.Second); err != nil {
log.Fatal("Timeout esperando elemento:", err)
}
```
## Notas
Usa `document.querySelector(selector) !== null` como condicion. Si `timeout <= 0` usa 10s por defecto. Los errores de `CdpEvaluate` durante el polling (pagina cargando) se ignoran y se reintenta en el siguiente ciclo.