New Page

New Page

Tipo: browser-new-page  ·  Paquete: Browser v1.0.9  ·  Salida: ZoanPageSession

Abre una nueva pestaña en un navegador ya abierto y devuelve su sesión de página. Úsala cuando necesitas trabajar con varias páginas a la vez dentro del mismo navegador: consultar otra sección en paralelo, comparar dos páginas o mantener un listado abierto mientras trabajas en otra.

Cómo funciona

A partir de cualquier sesión de página del navegador, crea una pestaña nueva (opcionalmente navegando a una url y esperando su evento load, hasta 30 s) y devuelve una ZoanPageSession que la representa. Pasa esa nueva sesión como page a las actividades que deban actuar sobre ella, y ciérrala con Close Page al terminar.

• Sesión aislada: salvo con userDataDir, la pestaña nueva se abre en un contexto propio, como una ventana de incógnito: no comparte cookies ni el inicio de sesión de las demás pestañas. Si necesitas la misma sesión iniciada, abre la pestaña desde la propia web con Click y expectNewTab = true, o navega en la misma pestaña con Navigate.
• Con un navegador abierto con userDataDir, la pestaña comparte el perfil y se ignoran viewport y userAgent.
• Un viewport con formato distinto de ANCHOxALTO se ignora sin error.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
session	ZoanPageSession	—	Cualquier sesión de página del navegador donde abrir la pestaña (de Open Browser, Attach Browser, Switch Page…).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
url	string	—	URL a la que navegar al abrir la pestaña. Vacío: pestaña en blanco.
viewport	string	—	Tamaño del área visible como ANCHOxALTO (ej. 1920x1080). Vacío: el tamaño de la ventana.
userAgent	string	—	Sobrescribe la cadena de user-agent que envía la pestaña.

Salida

Devuelve una ZoanPageSession que representa la nueva pestaña, ligada al mismo navegador (sirve también para Close Browser).

Ejemplo

Open Browser   browser = chrome   url = "https://portal.example.com"   → output: page
Browser New Page   session = page   url = "https://example.com/tasas"   → output: tasas
Page Get Text   page = tasas   selector = (#tasaDelDia)   → output: tasa
Close Page   page = tasas
Page Fill   page = page   selector = (#tasa)   value = tasa

Errores comunes

Mensaje	Causa y solución
'session' debe ser una ZoanPageSession o ZoanBrowserSession.	La variable está vacía o no contiene una sesión del navegador. Pasa la salida de Open Browser u otra sesión de página.
Timeout 30000ms exceeded	La url no terminó de cargar en 30 s. Abre la pestaña sin url y navega con Navigate, que admite timeout y waitUntil.

Actividades relacionadas

• Close Page — cerrar la pestaña al terminar.
• Switch Page — tomar una pestaña que abrió la propia web.
• Open Browser / Attach Browser — obtener la sesión del navegador.