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.1.0	impure	func CdpCollectConsole(c *CDPConn, durationMs int, maxEntries 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), hasta un maximo de maxEntries entradas (default 200). Devuelve un slice de ConsoleEntry (Type, Text, URL, Line, Timestamp). Es un snapshot de la ventana, no historico previo: filtra por timestamp para descartar el backlog de eventos que una conexion del pool acumulo antes de la llamada. Si se alcanza maxEntries deja de acumular pero no corta la ventana; anade una entrada final con Type=_truncated. 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. La función duerme la ventana completa aunque se alcance maxEntries antes name desc maxEntries tope de entradas a acumular; si <=0 usa 200. Al alcanzarlo se descartan las entradas posteriores (no se corta la ventana) y se añade una entrada final con Type=_truncated. Acota la salida en páginas verbosas (setInterval ruidoso, SPA que loguea sin parar)	slice de ConsoleEntry (Type, Text, URL, Line, Timestamp) con todo lo emitido en la ventana (filtrado de backlog previo a la llamada y acotado a maxEntries); si se truncó, la última entrada tiene Type=_truncated; 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,
// hasta un maximo de 100 entradas (descarta el backlog previo de la conexion).
entries, err := CdpCollectConsole(conn, 2000, 100)
if err != nil {
    log.Fatal(err)
}
for _, e := range entries {
    if e.Type == "_truncated" {
        fmt.Println("...", e.Text) // se alcanzo el cap de 100 entradas
        continue
    }
    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)

// Cap por defecto (200): pasar maxEntries <= 0.
entries, _ = CdpCollectConsole(conn, 1500, 0)

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 — y filtra el backlog. Solo captura eventos emitidos DURANTE la ventana durationMs. La función captura startMs (wall time, ms epoch) justo antes de habilitar los dominios y descarta todo evento con timestamp anterior a ese inicio. Esto resuelve el problema real con conexiones del pool que llevan rato abiertas con Runtime ya habilitado: cuando Runtime.enable se reenvía, Chrome flushea consoleAPICalled rezagados con timestamps antiguos; esos backlog se descartan por el filtro. Sin el filtro, en una página verbosa o con un setInterval la función devolvía cientos de entradas históricas que reventaban el output. Por qué OnEvent no basta: los handlers de OnEvent solo reciben eventos que lleguen al readLoop DESPUÉS del registro, pero el flush de Runtime.enable llega justo después y arrastra mensajes viejos — de ahí el backlog. El filtro por timestamp es la defensa que lo separa. Si quieres capturar el arranque, conéctate y llama ANTES de navegar, o navega dentro de la ventana.
• Eventos sin timestamp se aceptan. Si un evento llega con timestamp 0 (sin fechar) no se puede clasificar como backlog, así que se acumula. En la práctica casi siempre son nuevos.
• Log.entryAdded reporta en segundos, no ms. A diferencia de consoleAPICalled/exceptionThrown (ms epoch), Log.entryAdded da timestamp en segundos epoch. La función lo normaliza a ms (heurística: si el valor es varios órdenes menor que un ms epoch actual, lo multiplica por 1000) para que el filtro por startMs compare en el mismo dominio.
• Cap por cantidad (maxEntries). Al alcanzar maxEntries entradas (default 200) la función deja de acumular y descarta las posteriores, pero NO corta la ventana — sigue durmiendo hasta durationMs para no dejar los dominios CDP a medio drenar (handlers a medias) ni el estado de la conexión raro. Si se truncó, la última entrada del slice tiene Type == "_truncated" y un Text con el cap alcanzado; el caller debe filtrarla o tratarla como señal, no como un log real.
• Bloquea durante durationMs. La función duerme la goroutine la ventana completa antes de devolver — no hay early-return aunque ya tengas eventos o se alcance el cap. 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.