feat(browser): auto-commit con 44 cambios

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-06-06 12:49:54 +02:00
parent e2c073b8b7
commit 5b10b419a2
44 changed files with 2543 additions and 28 deletions
@@ -0,0 +1,63 @@
+---
+id: cdp_close_tab_go_browser
+name: cdp_close_tab
+kind: function
+lang: go
+domain: browser
+purity: impure
+version: 1.0.0
+tested: false
+description: "Cierra una pestaña Chrome por su ID via GET /json/close/<id>. Sin WebSocket — solo HTTP. Util para limpiar pestañas abiertas por automatizaciones."
+tags: [cdp, browser, tabs, navegator]
+signature: "func CdpCloseTab(host string, port int, tabID string) error"
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: error_go_core
+imports: []
+file_path: "functions/browser/cdp_list_tabs.go"
+example: |
+  tabs, _ := browser.CdpListTabs("localhost", 9222)
+  for _, t := range tabs {
+      if t.URL == "https://example.com" {
+          _ = browser.CdpCloseTab("localhost", 9222, t.ID)
+      }
+  }
+params:
+  - name: host
+    desc: "Hostname de la instancia Chrome (vacío = localhost)"
+  - name: port
+    desc: "Puerto CDP de remote debugging (habitualmente 9222)"
+  - name: tabID
+    desc: "ID de la pestaña a cerrar, obtenido de CdpTab.ID via CdpListTabs"
+output: "nil si la pestaña se cerró correctamente; error si tabID está vacío, la conexión falla o Chrome devuelve status != 200"
+---
+
+## Ejemplo
+
+```go
+// Listar tabs y cerrar la primera que coincida con una URL
+tabs, err := browser.CdpListTabs("localhost", 9222)
+if err != nil {
+    log.Fatal(err)
+}
+for _, t := range tabs {
+    if t.URL == "https://example.com/login" {
+        if err := browser.CdpCloseTab("localhost", 9222, t.ID); err != nil {
+            log.Printf("error cerrando tab %s: %v", t.ID, err)
+        }
+    }
+}
+```
+
+## Cuando usarla
+
+Después de terminar una sesión de scraping o automatización: cierra las pestañas abiertas programáticamente sin afectar el resto del perfil. También útil para liberar recursos cuando `CdpNewTab` ha creado muchas pestañas temporales.
+
+## Gotchas
+
+- No requiere conexión WebSocket previa; usa HTTP puro contra `/json/close/<id>`.
+- Si Chrome ya cerró la pestaña (o el ID es inválido), devuelve error de status HTTP.
+- El ID debe obtenerse de `CdpListTabs` — no es el índice visible del tab, es el UUID interno de Chrome.
+- No espera confirmación de cierre; para saber si la pestaña desapareció, volver a llamar `CdpListTabs`.