Open Browser

Open Browser

Tipo: browser-open  ·  Paquete: Browser v1.0.0  ·  Salida: ZoanPageSession

Abre un navegador web y devuelve una sesión de página lista para trabajar. Es el punto de partida de toda automatización web: casi siempre es la primera actividad del navegador en tu playbook.

Usa el navegador ya instalado en la máquina (Chrome o Edge), sin descargas adicionales. Con userDataDir puedes cargar el perfil real del usuario (sus cookies y sesiones iniciadas), útil para saltarte logins.

Cómo funciona

Tienes dos modos de uso (explicados en detalle en la introducción del paquete):

• Con body: las actividades dentro del sub-flujo heredan la sesión automáticamente y el navegador se cierra solo al terminar. La forma más simple.
• Sin body: guarda la sesión en una variable de salida y la pasas a las siguientes actividades; tú la cierras con Close Browser.

Parámetros requeridos

Ninguno. (Todos son opcionales — por defecto abre Chrome con una página en blanco.)

Parámetros opcionales

Parámetro	Editor	Descripción
browser	lista	Navegador a usar: chrome (por defecto) · edge · firefox · chromium. chrome/edge usan el del sistema; chromium usa el binario incluido por Playwright.
url	texto	URL a la que navegar al abrir. Si se omite, empieza en blanco.
headless	booleano	Ejecutar sin ventana visible (modo segundo plano). Por defecto false.
windowState	lista	Estado inicial de la ventana (si no es headless): maximized (def.) · normal · minimized.
timeout	número	Tiempo máximo (ms) para lanzar y cargar. Por defecto 30000.
slowMo	número	Ralentiza cada operación N ms (útil para depurar y ver qué hace el bot).
userDataDir	texto	Ruta al perfil del navegador. Carga cookies, sesiones y contraseñas reales. Chrome debe estar totalmente cerrado antes.
executablePath	texto	Ruta a un ejecutable de navegador específico. Sobrescribe browser.
args	JSON	Argumentos extra de lanzamiento del navegador.
keepOpen	booleano	Al usar body, mantener abierto el navegador al terminar y devolver la sesión como salida. Por defecto false.

Sub-flujos (lanes)

body opcional

Actividades a ejecutar con este navegador. Si se omite, devuelve la sesión como salida para usarla en pasos posteriores.

Ejemplos

Modo body (recomendado):

Open Browser   browser = chrome   url = "https://example.com"   headless = false
 └─ body:
      Page Get Text   selector = (h1)   → output: titulo
      Log             message = = "Título: " + titulo

Modo headless con salida (para producción desatendida):

Open Browser   browser = chrome   url = "https://portal.cliente.com"   headless = true   → output: page
...
Close Browser  session = = page

Atendido vs desatendido

Durante el diseño, usa headless = false para ver qué hace el bot. En producción desatendida (un servidor sin pantalla), usa headless = true. Probar primero con slowMo (ej. 500) ayuda a seguir cada paso visualmente.

Cargar el perfil real (userDataDir)

userDataDir te permite reusar la sesión ya iniciada del usuario (sin volver a hacer login), pero Chrome debe estar completamente cerrado antes de ejecutar, o fallará. Para credenciales, considera mejor Open Browser + login con credenciales seguras.

Actividades relacionadas

• Navigate — cambiar de URL una vez abierto.
• Attach Browser — reutilizar un navegador ya abierto en vez de abrir uno nuevo.
• Close Browser — cerrar la sesión (modo sin body).