62 lines
2.2 KiB
Markdown
62 lines
2.2 KiB
Markdown
---
|
|
id: cdp_delete_cookies_go_browser
|
|
name: cdp_delete_cookies
|
|
kind: function
|
|
lang: go
|
|
domain: browser
|
|
purity: impure
|
|
version: 1.0.0
|
|
tested: false
|
|
description: "Borra las cookies que coincidan con name (+ domain opcional) via Network.deleteCookies; si domain es vacío elimina en todos los dominios."
|
|
tags: [cdp, browser, cookie, network, navegator]
|
|
signature: "func CdpDeleteCookies(c *CDPConn, name, domain string) error"
|
|
uses_functions: []
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: error_go_core
|
|
imports: []
|
|
file_path: "functions/browser/cdp_delete_cookies.go"
|
|
example: |
|
|
conn, _ := CdpConnect(9222)
|
|
// Borrar cookie de sesion solo en el dominio concreto
|
|
err := CdpDeleteCookies(conn, "session_id", "app.example.com")
|
|
// Borrar en todos los dominios (sin filtro de dominio)
|
|
err = CdpDeleteCookies(conn, "tracking_cookie", "")
|
|
params:
|
|
- name: c
|
|
desc: "Conexion CDP activa al browser (obtenida con CdpConnect)"
|
|
- name: name
|
|
desc: "Nombre exacto de la cookie a borrar; obligatorio para Network.deleteCookies"
|
|
- name: domain
|
|
desc: "Dominio donde borrar la cookie; cadena vacía borra en todos los dominios que tengan esa cookie"
|
|
output: "nil si la cookie fue borrada (o no existia); error si falla la comunicacion CDP."
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
conn, _ := CdpConnect(9222)
|
|
|
|
// Borrar cookie de sesion solo en dominio especifico
|
|
if err := CdpDeleteCookies(conn, "session_id", "app.example.com"); err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
|
|
// Borrar cookie en todos los dominios
|
|
if err := CdpDeleteCookies(conn, "analytics_token", ""); err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
```
|
|
|
|
## Cuando usarla
|
|
|
|
Usar cuando necesitas forzar un logout de sesion especifica, limpiar una cookie de tracking antes de un test, o resetear el estado de autenticacion de un dominio concreto sin tocar el resto de cookies.
|
|
|
|
## Gotchas
|
|
|
|
- `name` es obligatorio en `Network.deleteCookies`; CDP devuelve error si se omite.
|
|
- Sin `domain`, CDP borra la cookie en TODOS los dominios que tengan esa cookie — puede cerrar sesiones inesperadas en otros dominios abiertos.
|
|
- No devuelve error si la cookie no existia; la operacion es idempotente.
|
|
- Para borrar todas las cookies de golpe usar `CdpClearCookies` en su lugar.
|