Download File

Download File

Tipo: page-download-file  ·  Paquete: Browser v1.0.9  ·  Salida: string

Descarga un archivo cuando ya tienes su enlace: lo sacaste de una tabla, del href de un botón o de otra página. No hace clic en nada; pide el archivo directamente y lo guarda en disco, devolviendo la ruta completa.

La descarga usa la misma sesión del navegador: comparte sus cookies y su estado de inicio de sesión. Por eso funciona con archivos que solo se pueden bajar después de entrar al portal, donde una petición HTTP normal recibiría la página de login en lugar del archivo.

¿Download File o Wait for Download?

• Tienes la URL del archivo → Download File (esta actividad).
• La descarga se dispara con un clic y no conoces la URL → Wait for Download.

Cómo funciona

1. Si la url es relativa (/informes/2026.pdf), la completa con la dirección de la página actual.
2. Pide el archivo (GET) con las cookies de la sesión del navegador, hasta timeout.
3. Si el servidor responde con un código que no es de éxito (fuera de 200-299), falla con ese código.
4. Lo guarda en outputPath y devuelve la ruta completa del archivo guardado.

Si outputPath es una carpeta, el nombre del archivo es el que indica el servidor (cabecera Content-Disposition, con prioridad para filename*, que admite tildes) o, si no lo indica, el último tramo de la URL. Si no hay ningún nombre aprovechable, se guarda como download. El nombre se limpia de rutas y caracteres no válidos, así que nunca se escribe fuera de la carpeta indicada.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
url	string	—	URL del archivo a descargar. Las URL relativas se completan con la de la página actual.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
page	ZoanPageSession	—	La sesión de página. Dentro del body de Open Browser o Attach Browser se hereda sola.
outputPath	string	carpeta temporal	Carpeta o ruta de archivo donde guardar. Si das una carpeta, el nombre sale del servidor o de la URL. Vacío: la carpeta temporal del sistema.
timeout	number	30000	Tiempo máximo en ms para la solicitud. 0 o negativo: el valor por defecto. No usa el tiempo de espera del proyecto.

Salida

Devuelve un string con la ruta completa del archivo guardado, p. ej. C:\Descargas\reportes\reporte-2026-09.xlsx.

Ejemplo

Leer el enlace de un reporte y descargarlo a una carpeta:

Open Browser   browser = chrome   url = "https://portal.example.com/reportes"
 └─ body:
      Page Get Attribute   selector = (#reporteMensual)   attribute = "href"   → output: enlace
      Download File        url = enlace   outputPath = "C:\Descargas\reportes"   → output: rutaReporte
      Excel Open           path = rutaReporte   → output: libro

Guardar con un nombre elegido por ti:

Download File   page = page   url = "/facturas/FV-1042.pdf"   outputPath = "C:\Facturas\FV-1042.pdf"

Carpeta o archivo

outputPath se trata como carpeta si ya existe como carpeta, si termina en \ o /, o si no tiene extensión; en cualquier otro caso, como ruta de archivo. Las carpetas que falten se crean solas, y un archivo con el mismo nombre se sobrescribe.

Errores comunes

Mensaje	Causa y solución
'url' es obligatorio.	url está vacía. Revisa la variable de la que sale el enlace.
'url' no es una URL válida y no se pudo resolver respecto a la página actual.	La URL no es válida ni se pudo completar con la de la página actual.
El servidor respondió HTTP 404 Not Found.	El servidor no encontró el archivo. Revisa la URL.
El servidor respondió HTTP 401 … / 403 …	La sesión no tiene permiso: el inicio de sesión caducó o esa cuenta no puede ver el archivo. Vuelve a iniciar sesión antes de descargar.
Timeout 30000ms exceeded	El servidor tardó más que timeout en entregar el archivo. Súbelo para archivos grandes o servidores lentos.
'page' debe ser una ZoanPageSession.	page está vacío fuera de un body.

Actividades relacionadas

• Wait for Download — cuando la descarga la dispara un clic.
• Get Attribute — leer el href de un enlace.
• Excel Open / Read File — procesar el archivo descargado.