Automatización: navegación y lectura de la página

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.