---
id: "navegador-automacao-navegacao"
titulo: "Automatización: navegación y lectura de la página"
resumo: "Comandos que abren direcciones, capturan la estructura de la página, esperan condiciones y exportan contenido."
idioma: "es"
tipo: "referencia"
categoria: "telas"
aplicavelDesde: "0.0.16"
capabilities: ["browser.page.navigate", "browser.snapshot", "browser.screenshot", "browser.scroll", "browser.pdf", "browser.script.eval", "browser.wait"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/es/ferramentas/navegador/automacao-referencia-navegacao/"
fonte: "pt-br/ferramentas/navegador/automacao-referencia-navegacao.md"
caminhoPublico: "docs/publica/es/ferramentas/navegador/automacao-referencia-navegacao.md"
hashFonte: "sha256:04389174dcf0fd7420d57b83f8aa7f807d2701b7dfd389cae9274340bc16a272"
hashDestaPagina: "sha256:0a858814375fd5a650c28de096bc46035c2b18245096578c273e2342bff7cc9a"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/ferramentas/navegador/automacao-referencia-navegacao.md fonteHash=sha256:04389174dcf0fd7420d57b83f8aa7f807d2701b7dfd389cae9274340bc16a272 estado=atual -->

Los comandos de abajo actúan sobre la **pestaña activa** del navegador. Comandos, flags y valores son **literales** — no se traducen.

## Cómo elegir el objetivo

| Flag | Objetivo |
|---|---|
| `--page <id>` | Una página específica, por su identificador global |
| `--node <tarjeta>` | La pestaña referenciada por una tarjeta del Canvas |
| `--workspace <selector>` | El workspace |

- **`--page` y `--node` juntos son un error.**
- Sin ninguno de los tres, el objetivo es la **pestaña activa del workspace del directorio actual**.
- Una tarjeta resuelve el **workspace de la tarjeta**, no el del directorio desde el que llamaste.

## Navegar

```
elyra goto --url <url> [--page <id> | --node <tarjeta>] [--workspace <selector>] [--json]
elyra back [--page <id> | --node <tarjeta>] [--workspace <selector>] [--json]
elyra forward [--page <id> | --node <tarjeta>] [--workspace <selector>] [--json]
elyra reload [--page <id> | --node <tarjeta>] [--workspace <selector>] [--json]
```

- `goto` **exige `--url`**.
- `goto` y `reload` esperan a que la red quede ociosa, con **timeout de 60 s** en la llamada.
- La respuesta trae la **URL y el título** resultantes; `back` y `forward` traen la URL de destino.
- `goto` acepta cualquier URL `http(s)` o archivo — es la puerta de entrada de contenido externo al navegador integrado.

## Leer la página

```
elyra snapshot [--page <id> | --node <tarjeta>] [--workspace <selector>] [--json]
```

`snapshot` devuelve el **árbol de accesibilidad** de la pestaña activa. Es la fuente de los `ref` que usan `--element` en los comandos de interacción.

> **Un `ref` queda obsoleto después de navegar.** La propia CLI recomienda tomar un snapshot nuevo después de actuar, para revisar qué se asentó.

## Capturar imagen y PDF

```
elyra screenshot [--format <png|jpeg>] [--page <id> | --node <tarjeta>] [--workspace <selector>] [--json]
elyra full-screenshot [--format <png|jpeg>] [--page <id> | --node <tarjeta>] [--workspace <selector>] [--json]
elyra pdf [--page <id> | --node <tarjeta>] [--workspace <selector>] [--json]
```

- `screenshot` captura el viewport; `full-screenshot` captura la página completa.
- `--format` acepta **`png` o `jpeg`**. Cualquier otro valor se rechaza — incluido `webp`.
- `full-screenshot` normaliza cualquier formato distinto de `jpeg` a `png`.
- `pdf` exporta la pestaña e **informa el tamaño del contenido generado**. Los PDF grandes viajan en base64 en la respuesta.

## Desplazar

```
elyra scroll --direction <up|down> [--amount <pixels>] [--page <id> | --node <tarjeta>] [--workspace <selector>] [--json]
```

`--direction` es obligatorio y solo acepta `up` o `down`; otro valor falla con error de argumento. `--amount` es opcional.

## Esperar

```
elyra wait [--selector <sel>] [--text <texto>] [--url <patrón>] [--load <estado>] [--fn <js>] [--state <hidden|visible>] [--timeout <ms>] [--page <id> | --node <tarjeta>] [--workspace <selector>] [--json]
```

Formas de espera aceptadas: elemento por selector, texto, patrón de URL, estado de carga, condición en JavaScript y visibilidad (`hidden` o `visible`).

- El timeout predeterminado de la llamada es de **60 s**; al informar `--timeout`, el presupuesto pasa a ser el valor informado más 5 s.
- **Una espera larga sin `--timeout` puede agotar el presupuesto de quien llamó.**

## Ejecutar código en la página

```
elyra eval --expression <js> [--page <id> | --node <tarjeta>] [--workspace <selector>] [--json]
elyra exec --command "<comando agent-browser>" [--page <id> | --node <tarjeta>] [--workspace <selector>] [--json]
```

- `eval` exige `--expression` y devuelve el resultado de la expresión.
- `exec` reenvía un comando bruto al navegador de la pestaña activa y devuelve la salida cruda.
- **`exec` no es validado por la CLI más allá de exigir `--command`.**

> **`eval` y `exec` ejecutan código arbitrario en el contexto de la página** — poder total sobre la pestaña, incluido lo que esté logueado en ella. Úsalos solo en páginas y perfiles que aceptas exponer, y nunca en un perfil con sesión real sin necesidad.