fn_registry/functions/browser/cdp_collect_console.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
cdp_collect_console	function	go	browser	1.0.0	impure	func CdpCollectConsole(c *CDPConn, durationMs int) ([]ConsoleEntry, error)	Captura un snapshot temporal del log de consola y diagnostico de una pagina Chrome via CDP. Habilita los dominios Runtime y Log, se suscribe a Runtime.consoleAPICalled (console.log/info/warn/error con args concatenados), Runtime.exceptionThrown (errores JS no capturados, type=exception con descripcion + stack) y Log.entryAdded (avisos del propio navegador: network, security, deprecaciones) y acumula todo lo que ocurra durante durationMs ms (default 1500). Devuelve un slice de ConsoleEntry (Type, Text, URL, Line, Timestamp). Es un snapshot de la ventana, no historico previo. Robusta ante silencio: devuelve slice vacio si no llega ningun evento.	chrome cdp browser automation console devtools debug diagnostics logs errors exceptions flow-replay				false	error_go_core	encoding/json fmt strings sync time	name desc c conexión CDP activa (*CDPConn) contra una pestaña Chrome con el target abierto name desc durationMs ventana de captura en milisegundos; si <=0 usa 1500ms. Es el tiempo durante el cual se acumulan eventos de consola/excepcion/log antes de devolver	slice de ConsoleEntry (Type, Text, URL, Line, Timestamp) con todo lo emitido en la ventana; slice vacío (no nil, no error) si no hubo eventos; error solo si la conexión es nula o falla Runtime.enable	false			functions/browser/cdp_collect_console.go

Ejemplo

conn, _ := CdpConnect(9222)
CdpNavigate(conn, "https://example.com")

// Captura todo lo que la pagina escriba en consola durante 2 segundos
// mientras se carga / interactua.
entries, err := CdpCollectConsole(conn, 2000)
if err != nil {
    log.Fatal(err)
}
for _, e := range entries {
    fmt.Printf("[%s] %s  (%s:%d)\n", e.Type, e.Text, e.URL, e.Line)
}
// Ejemplo de salida:
// [error] Uncaught TypeError: x is not a function  (https://example.com/app.js:42)
// [warning] Mixed Content: requested an insecure resource  (https://example.com:0)
// [log] app initialized  (https://example.com/app.js:5)

Cuando usarla

Cuando necesitas ver qué errores, warnings o mensajes de consola produce una página justo después de navegar o tras disparar una acción (click, submit). Úsala para depurar por qué un flujo web falla en silencio (excepción JS no capturada, recurso bloqueado por CSP/mixed-content, error de red que solo aparece en consola), para validar que una SPA arrancó sin errores, o como paso de diagnóstico dentro de un flow-replay antes de dar por bueno un replay. Llámala envolviendo la acción que quieres observar: navega/interactúa y deja que la ventana de captura recoja lo que emita.

Gotchas

• Impura: requiere Chrome vivo. Necesita una conexión CDP activa (*CDPConn) contra una instancia de Chrome con el target abierto. No funciona sin navegador.
• Es un snapshot temporal, no histórico. Solo captura eventos emitidos DURANTE la ventana durationMs. Los mensajes que la página imprimió antes de llamar a la función no se recuperan (excepto los que Runtime.enable reenvía al activarse, que Chrome flushea de forma limitada). Si quieres capturar el arranque, conéctate y llama ANTES de navegar, o navega dentro de la ventana.
• Bloquea durante durationMs. La función duerme la goroutine la ventana completa antes de devolver — no hay early-return aunque ya tengas eventos. Elige durationMs acorde a lo que esperas observar (1500ms default suele bastar para el load inicial).
• Type mezcla tres taxonomías. consoleAPICalled usa log|info|warning|error|debug|...; exceptionThrown siempre marca exception; Log.entryAdded usa el level del navegador (verbose|info|warning|error). Filtra por substring (warn, error) si quieres agrupar severidades; nota que console.warn produce warning, no warn.
• Line es 1-based. CDP reporta lineNumber 0-based; esta función suma 1 para que coincida con lo que muestran las DevTools. Los Log.entryAdded se dejan tal cual los da Chrome.
• No deshabilita Runtime al salir. Otras funciones del package (ej. cdp_pick_element_js) dependen de Runtime.consoleAPICalled; deshabilitarlo rompería sus handlers. Sí cierra el dominio Log que abre aquí.
• Log.enable puede no estar disponible en algunos targets (workers, ciertos contextos). Si falla, la función NO aborta: sigue capturando Runtime.* y solo pierde los avisos de Log.entryAdded.

Notas

ConsoleEntry se define como tipo simple del package browser en el mismo .go (igual que HarEntry/HarHeader en cdp_har_record.go), no como tipo del registry — evita import circular y mantiene la firma autosuficiente. La acumulación usa un sync.Mutex porque los handlers de OnEvent corren en la goroutine del readLoop de CDPConn, concurrente con la goroutine que duerme la ventana. La conversión de args de consoleAPICalled serializa objetos/arrays a JSON real (no la repr %v de Go) para que datos estructurados sean parseables.