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,64 @@
+---
+id: cdp_nav_forward_go_browser
+name: cdp_nav_forward
+kind: function
+lang: go
+domain: browser
+purity: impure
+version: 1.0.0
+tested: false
+description: "Avanza una entrada en el historial de navegación de la pestaña activa via Page.getNavigationHistory + Page.navigateToHistoryEntry. Equivalente a pulsar el botón Adelante del navegador."
+tags: [cdp, browser, navigation, navegator]
+signature: "func CdpNavForward(c *CDPConn) error"
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: error_go_core
+imports: []
+file_path: "functions/browser/cdp_nav_forward.go"
+example: |
+  conn, _ := browser.CdpConnect(9222)
+  defer browser.CdpClose(conn, 0)
+  _ = browser.CdpNavigate(conn, "https://example.com/paso1")
+  _ = browser.CdpNavigate(conn, "https://example.com/paso2")
+  _ = browser.CdpNavBack(conn)   // volver a /paso1
+  // Avanzar de nuevo a /paso2
+  if err := browser.CdpNavForward(conn); err != nil {
+      log.Println(err)
+  }
+params:
+  - name: c
+    desc: "Conexión CDP activa obtenida de CdpConnect, apuntando a la pestaña que se quiere avanzar"
+output: "nil si navegó correctamente a la entrada siguiente; error si ya estamos al final del historial, la conexión es nula o el cast de tipos falla (respuesta CDP malformada)"
+---
+
+## Ejemplo
+
+```go
+conn, err := browser.CdpConnect(9222)
+if err != nil {
+    log.Fatal(err)
+}
+defer browser.CdpClose(conn, 0)
+
+_ = browser.CdpNavigate(conn, "https://metabase.local/dashboard/1")
+_ = browser.CdpNavigate(conn, "https://metabase.local/question/42")
+_ = browser.CdpNavBack(conn)  // vuelve a /dashboard/1
+
+// Avanzar de nuevo a /question/42
+if err := browser.CdpNavForward(conn); err != nil {
+    log.Printf("no se pudo avanzar: %v", err)
+}
+```
+
+## Cuando usarla
+
+Cuando un flujo de automatización ha retrocedido con `CdpNavBack` y necesita volver a avanzar sin conocer la URL destino. Útil para recorrer un historial de páginas hacia adelante y hacia atrás de forma programática, por ejemplo en herramientas de replay de sesiones.
+
+## Gotchas
+
+- Navega dentro del historial de ESA pestaña CDP (sesión WS), no del perfil en disco ni del historial global de Chrome.
+- Si `currentIndex` es el último elemento del historial (`currentIndex == len(entries) - 1`), retorna error "ya en el final del historial" — no es un fallo de red, es estado válido.
+- El historial se trunca cuando se navega a una URL nueva estando en una entrada intermedia: las entradas "adelante" desaparecen, igual que en un navegador real.
+- No espera a que la página de destino cargue; encadenar con `CdpWaitLoad` o `CdpWaitIdle` si necesitas esperar la carga completa.