fn_registry/functions/browser/cdp_close.md at master

Files

T

Egutierrez ccfa5bc78b feat(browser): funciones anti-deteccion + perfiles para web_scraping

Funciones nuevas del dominio browser (grupo navegator):
- cdp_move_mouse_human / cdp_click_human: movimiento de raton con curva
  de Bezier cubica, easing y micro-jitter para imitar comportamiento
  humano y reducir deteccion de automatizacion.
- cdp_wait_idle: espera network-idle contando requests en vuelo via
  eventos CDP Network.*; inmune a extensiones que mutan el DOM
  (Dark Reader, uBlock) y a animaciones JS.
- list_chrome_profiles: lista perfiles de un user-data-dir (extensiones,
  nombre legible, preferencias).
- prepare_chrome_profile (bash): clona un user-data-dir conservando solo
  una whitelist de extensiones (default uBlock Origin Lite).

Modificadas:
- chrome_launch: Linux-first (chromium/google-chrome/brave antes que
  chrome.exe), KeepExtensions y Setpgid para matar el arbol con cdp_close.
- cdp_close: kill por grupo de proceso.

Todas con tests verdes (go test ./functions/browser ok).

2026-06-05 16:25:11 +02:00

2.9 KiB

Raw Permalink Blame History

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_close

function

browser

1.1.0

impure

func CdpClose(c *CDPConn, pid int) error

Cierra la conexion WebSocket CDP y opcionalmente mata el proceso Chrome por PID. En Linux nativo mata el grupo de proceso completo (pid == pgid cuando ChromeLaunch seteo Setpgid=true), lo que incluye zygote, gpu-process y renderers. Si c es nil, solo mata el proceso. Si pid <= 0, solo cierra la conexion. Siempre intenta ambas operaciones aunque una falle.

chrome

cdp

browser

automation

cleanup

devtools

linux

false

error_go_core

fmt

syscall

name	desc
c	conexión CDP (puede ser nil para solo matar el proceso)

name	desc
pid	PID del proceso Chrome (0 para no matar; en Linux nativo este PID es tambien el PGID cuando ChromeLaunch uso Setpgid)

error si falla la desconexion o el cierre del proceso; nil si todo OK

false

functions/browser/cdp_close.go

Ejemplo

pid, _ := ChromeLaunch(ChromeLaunchOpts{Port: 9222, Headless: true})
conn, _ := CdpConnect(9222)

defer CdpClose(conn, pid)  // cierra WebSocket y mata grupo Chrome completo

// O por separado:
defer CdpClose(conn, 0)  // solo cierra WebSocket
defer CdpClose(nil, pid) // solo mata Chrome (y su grupo en Linux)

Cuando usarla

Usar siempre en defer después de ChromeLaunch para garantizar cleanup del proceso Chrome y del WebSocket CDP. En Linux nativo mata el árbol completo de procesos (zygote, gpu, renderers) evitando procesos zombie.

Gotchas

Kill por grupo (Linux nativo): usa syscall.Kill(-pid, SIGKILL) que envía la señal a todos los procesos del grupo. Funciona porque ChromeLaunch setea Setpgid: true en Linux, haciendo que pid == pgid. En WSL+chrome.exe el Setpgid no se aplica, por lo que el fallback a os.FindProcess(pid).Kill() maneja ese caso.
Fallback automático: si el kill de grupo falla (proceso ya terminado, PID no encontrado, o es WSL+exe), intenta matar solo el proceso raiz. En ambos casos el error no es fatal si el proceso ya no existe.
Doble cierre seguro: marca c.closed = true para evitar doble cierre del WebSocket. El segundo CdpClose con la misma conexión es un no-op en el lado WebSocket.
Primer error: si tanto el cierre WebSocket como el kill fallan, retorna el error del WebSocket (el primero en ejecutarse). El kill siempre se intenta aunque el WebSocket falle.

Notas

Usar en defer para garantizar cleanup. Si tanto la conexion como el proceso son invalidos, el error retornado corresponde al primero que fallo.

Capability growth log

v1.1.0 (2026-06-05) — Linux-native kill: usa syscall.Kill(-pid, SIGKILL) para matar grupo completo (zygote, gpu, renderers), con fallback a os.FindProcess para WSL+exe o proceso ya terminado

2.9 KiB Raw Permalink Blame History