64 lines
2.2 KiB
Markdown
64 lines
2.2 KiB
Markdown
---
|
|
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`.
|