---
id: "navegador-automacao-interacao"
titulo: "Automatización: interacción con la página"
resumo: "Comandos que hacen clic, rellenan, escriben, arrastran y leen el estado de elementos por referencia de snapshot."
idioma: "es"
tipo: "referencia"
categoria: "telas"
aplicavelDesde: "0.0.16"
capabilities: ["browser.element.interact", "browser.element.inspect", "browser.mouse.control", "browser.form.fill"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/es/ferramentas/navegador/automacao-referencia-interacao/"
fonte: "pt-br/ferramentas/navegador/automacao-referencia-interacao.md"
caminhoPublico: "docs/publica/es/ferramentas/navegador/automacao-referencia-interacao.md"
hashFonte: "sha256:3d101604495fd2ad64acfa3e19faeb79df51c9b0cc0ae215d69e1e735d0f5ddb"
hashDestaPagina: "sha256:0c0210177aa3bf0d8235b2ed6235c99e482b14b78b2da63e203148a40cc7a80d"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/ferramentas/navegador/automacao-referencia-interacao.md fonteHash=sha256:3d101604495fd2ad64acfa3e19faeb79df51c9b0cc0ae215d69e1e735d0f5ddb estado=atual -->

Comandos, flags y valores son **literales** — no se traducen. Todos aceptan los flags de objetivo `--page`/`--node`/`--workspace` descritos en [Automatización: navegación](/docs/es/ferramentas/navegador/automacao-referencia-navegacao/), y sin objetivo actúan sobre la pestaña activa del workspace actual.

## La referencia viene del snapshot

Los comandos por elemento usan **`--element <ref>`**, y esos `ref` vienen de `elyra snapshot`.

- Toma el snapshot, usa los `ref` en la misma página.
- **Después de navegar o cambiar la página, los `ref` antiguos ya no valen** — toma un snapshot nuevo.
- La CLI recomienda, después de cada acción, tomar un snapshot nuevo para revisar qué se asentó realmente.

## Acciones por referencia

| Comando | Uso |
|---|---|
| `elyra click --element <ref>` | Clic |
| `elyra dblclick --element <ref>` | Doble clic |
| `elyra hover --element <ref>` | Pasar el mouse |
| `elyra focus --element <ref>` | Dar foco |
| `elyra fill --element <ref> --value <texto>` | Limpiar y rellenar |
| `elyra type --input <texto>` | Escribir en el foco actual |
| `elyra select --element <ref> --value <valor>` | Elegir opción de lista |
| `elyra check --element <ref>` / `elyra uncheck --element <ref>` | Marcar / desmarcar casilla o radio |
| `elyra clear --element <ref>` | Limpiar el contenido del campo |
| `elyra select-all --element <ref>` | Seleccionar todo el texto del campo |
| `elyra keypress --key <nombre>` | Pulsar tecla (`Enter`, `Tab`, `Escape`, `ArrowDown`…) |
| `elyra drag --from <ref> --to <ref>` | Arrastrar de un elemento a otro |
| `elyra upload --element <ref> --files <ruta,...>` | Enviar archivos locales a un campo de archivo |

Obligatoriedades: `fill` y `select` exigen `--value`; `drag` exige `--from` y `--to`; `upload` exige `--files`; `keypress` exige `--key`. `check` y `uncheck` son el mismo handler parametrizado.

> **`clear` borra sin deshacer.** **`upload` envía archivos de tu disco a la página** — revisa qué va y hacia dónde.

## Rellenar varios campos de una vez

```
elyra fill-form (--fields '<json>' | --fields-file <ruta>) [--page <id>] [--workspace <selector>] [--json]
```

- `--fields` es un arreglo JSON con la forma `[{"element":"<ref>","value":"<texto>"}]`, con `ref` provenientes de `snapshot`.
- `--fields` y `--fields-file` son **mutuamente excluyentes**; informar los dos es un error.
- **Cada campo se reporta**: el resultado dice qué entró y qué falló. Usa `elyra snapshot --json` para revisar.
- Un archivo inválido o vacío falla.

## Leer estado y propiedad

| Comando | Qué devuelve |
|---|---|
| `elyra get --what text\|html\|value\|url\|title\|count\|box [--element <ref>]` | Propiedad del elemento — o de la página, cuando la propiedad es de la página |
| `elyra is --what visible\|enabled\|checked --element <ref>` | Estado del elemento |
| `elyra find --locator <tipo> --value <texto> --action <acción>` | Localiza por locator semántico y ejecuta la acción |
| `elyra highlight --selector <ref>` | Resalta el elemento |
| `elyra scrollintoview --element <ref>` | Desplaza hasta el elemento |
| `elyra inserttext --text <texto>` | Inserta texto **sin eventos de tecla** |

> **`inserttext` no dispara `keydown` ni `keyup`.** Las páginas que reaccionan a eventos de tecla no se comportan como si hubieras escrito — para esos casos, usa escritura real.

## Mouse de bajo nivel

```
elyra mouse move --x <n> --y <n> [--page <id>] [--workspace <selector>] [--json]
elyra mouse down [--button <left|right|middle>] [--page <id>] [--workspace <selector>] [--json]
elyra mouse up [--button <left|right|middle>] [--page <id>] [--workspace <selector>] [--json]
elyra mouse wheel --dy <n> [--dx <n>] [--page <id>] [--workspace <selector>] [--json]
```

- `mouse move` exige `--x` y `--y`; `mouse wheel` exige `--dy`, con `--dx` opcional.
- Las coordenadas son **absolutas en la página** y dependen del viewport actual. Sin un snapshot reciente, el objetivo puede errar — en páginas con desplazamiento, el objetivo cambia sin aviso.