WebEngineDownloadRequest QML Type
Proporciona información sobre una descarga. Más...
| Import Statement: | import QtWebEngine |
| In C++: | QWebEngineDownloadRequest |
Propiedades
- downloadDirectory : string
- downloadFileName : string
- id : int
- interruptReason : enumeration
- interruptReasonString : string
- isFinished : bool
- isPaused : bool
- isSavePageDownload : bool
- mimeType : string
- receivedBytes : int
- savePageFormat : enumeration
- state : enumeration
- suggestedFileName : string
- totalBytes : int
- url : url
- view : WebEngineView
Métodos
Descripción detallada
WebEngineDownloadRequest modela una descarga a lo largo de su ciclo de vida, comenzando con una solicitud de descarga pendiente y terminando con una descarga completada. Puede utilizarse, por ejemplo, para obtener información sobre nuevas descargas, supervisar el progreso y pausar, reanudar y cancelar descargas.
Las descargas suelen activarse por la interacción del usuario en una página web. Es responsabilidad de WebEngineProfile notificar a la aplicación las nuevas solicitudes de descarga, lo que hace emitiendo la señal downloadRequested junto con una WebEngineDownloadRequest recién creada. La aplicación puede entonces examinar este elemento y decidir si lo acepta o no. Un gestor de señales debe llamar explícitamente a accept() en el elemento para que Qt WebEngine comience realmente a descargar y escribir datos en el disco. Si ningún gestor de señales llama a accept(), la solicitud de descarga se rechazará automáticamente y no se escribirá nada en el disco.
Nota: Algunas propiedades, como la ruta en la que se guardará el archivo, sólo pueden cambiarse antes de llamar a accept().
Ciclo de vida de los objetos
Se garantiza que todos los objetos son válidos durante la emisión de la señal downloadRequested. Si accept() no es llamado por ningún gestor de señales, el elemento se borrará inmediatamente después de la emisión de la señal. Esto significa que la aplicación no debe mantener referencias a elementos de descarga rechazados.
Descargas de páginas web
Además de las descargas normales de archivos, que consisten simplemente en recuperar algunos bytes brutos de la red y escribirlos en el disco, Qt WebEngine también permite guardar páginas web completas, lo que implica analizar el HTML de la página, descargar cualquier recurso dependiente y, potencialmente, empaquetarlo todo en un formato de archivo especial (savePageFormat). Para comprobar si una descarga es de un archivo o de una página web, utilice isSavePageDownload.
Véase también WebEngineProfile, WebEngineProfile::downloadRequested y WebEngineProfile::downloadFinished.
Documentación de propiedades
downloadDirectory : string
Contiene la ruta de destino completa (sin nombre de archivo) a la que se están descargando los datos.
El directorio de descarga sólo puede establecerse en el gestor downloadRequested antes de que se acepte la descarga.
Véase también WebEngineProfile::downloadRequested() y accept().
downloadFileName : string
Contiene el nombre del archivo en el que se están descargando los datos.
El nombre del archivo de descarga sólo puede establecerse en el gestor downloadRequested antes de que se acepte la descarga.
Véase también WebEngineProfile::downloadRequested() y accept().
id : int [read-only]
Contiene el ID del elemento de descarga.
interruptReason : enumeration [read-only]
Devuelve el motivo por el que se interrumpió la descarga:
| Constante | Descripción |
|---|---|
WebEngineDownloadRequest.NoReason | Razón desconocida o no interrumpida. |
WebEngineDownloadRequest.FileFailed | Fallo general de la operación de archivo. |
WebEngineDownloadRequest.FileAccessDenied | El archivo no se puede escribir localmente debido a restricciones de acceso. |
WebEngineDownloadRequest.FileNoSpace | Espacio insuficiente en la unidad de destino. |
WebEngineDownloadRequest.FileNameTooLong | El nombre del directorio o del archivo es demasiado largo. |
WebEngineDownloadRequest.FileTooLarge | El tamaño del archivo supera la limitación del sistema de archivos. |
WebEngineDownloadRequest.FileVirusInfected | El archivo está infectado por un virus. |
WebEngineDownloadRequest.FileTransientError | Problema temporal (por ejemplo, el archivo está en uso, se ha quedado sin memoria o se han abierto demasiados archivos a la vez). |
WebEngineDownloadRequest.FileBlocked | El fichero ha sido bloqueado debido a una política local. |
WebEngineDownloadRequest.FileSecurityCheckFailed | Un intento de comprobar la seguridad de la descarga falló debido a razones inesperadas. |
WebEngineDownloadRequest.FileTooShort | Se intentó buscar más allá del final de un archivo al abrir un archivo (como parte de la reanudación de una descarga interrumpida previamente). |
WebEngineDownloadRequest.FileHashMismatch | El archivo parcial no coincidía con el hash esperado. |
WebEngineDownloadRequest.NetworkFailed | Fallo general de la red. |
WebEngineDownloadRequest.NetworkTimeout | Se ha agotado el tiempo de espera de la operación de red. |
WebEngineDownloadRequest.NetworkDisconnected | Se ha interrumpido la conexión de red. |
WebEngineDownloadRequest.NetworkServerDown | El servidor se ha caído. |
WebEngineDownloadRequest.NetworkInvalidRequest | La solicitud de red no era válida (por ejemplo, la URL original o redirigida no es válida, tiene un esquema no compatible o no está permitida por la política). |
WebEngineDownloadRequest.ServerFailed | Fallo general del servidor. |
WebEngineDownloadRequest.ServerBadContent | El servidor no dispone de los datos solicitados. |
WebEngineDownloadRequest.ServerUnauthorized | El servidor no autorizó el acceso al recurso. |
WebEngineDownloadRequest.ServerCertProblem | Se ha producido un problema con el certificado del servidor. |
WebEngineDownloadRequest.ServerForbidden | Acceso prohibido por el servidor. |
WebEngineDownloadRequest.ServerUnreachable | Respuesta inesperada del servidor (puede indicar que el servidor que responde puede no ser el servidor previsto). |
WebEngineDownloadRequest.UserCanceled | El usuario canceló la descarga. |
Véase también interruptReasonString.
interruptReasonString : string [read-only]
Devuelve una descripción legible por humanos del motivo por el que se ha interrumpido la descarga.
Véase también interruptReason.
isFinished : bool [read-only]
Si esta descarga ha finalizado (completada, cancelada o en estado interrumpido no reanudable).
isPaused : bool [read-only]
Si esta descarga está en pausa.
isSavePageDownload : bool [read-only]
Si se trata de una solicitud de descarga para guardar una página web o un archivo.
Véase también savePageFormat.
mimeType : string [read-only]
Contiene el tipo MIME de la descarga.
receivedBytes : int [read-only]
Contiene la cantidad de datos en bytes que se han descargado hasta el momento.
savePageFormat : enumeration
Describe el formato que se utiliza para guardar una página web.
| Constante | Descripción |
|---|---|
WebEngineDownloadRequest.UnknownSaveFormat | No se trata de una solicitud para descargar una página web completa. |
WebEngineDownloadRequest.SingleHtmlSaveFormat | La página se guarda como una única página HTML. Los recursos como las imágenes no se guardan. |
WebEngineDownloadRequest.CompleteHtmlSaveFormat | La página se guarda como una página HTML completa, por ejemplo, un directorio que contenga la página HTML única y los recursos. |
WebEngineDownloadRequest.MimeHtmlSaveFormat | La página se guarda como una página web completa en formato HTML MIME. |
state : enumeration [read-only]
Describe el estado de la descarga:
| Constante | Descripción |
|---|---|
WebEngineDownloadRequest.DownloadRequested | Se ha solicitado la descarga, pero aún no se ha aceptado. |
WebEngineDownloadRequest.DownloadInProgress | La descarga está en curso. |
WebEngineDownloadRequest.DownloadCompleted | La descarga se ha completado correctamente. |
WebEngineDownloadRequest.DownloadCancelled | La descarga ha sido cancelada por el usuario. |
WebEngineDownloadRequest.DownloadInterrupted | La descarga ha sido interrumpida (por el servidor o por pérdida de conectividad). |
suggestedFileName : string [read-only]
Devuelve el nombre de archivo sugerido.
totalBytes : int [read-only]
Indica la cantidad total de datos a descargar en bytes.
-1 significa que se desconoce el tamaño total.
url : url [read-only]
Devuelve la URL de origen de la descarga.
view : WebEngineView [read-only]
Devuelve la vista en la que se solicitó la descarga. Si la descarga no fue provocada por el contenido de una vista, se devuelve nullptr.
Véase también WebEngineView.
Documentación del método
void accept()
Acepta la solicitud de descarga, que iniciará la descarga.
Si el elemento se encuentra en el estado DownloadRequested, pasará al estado DownloadInProgress y comenzará la descarga. Si el elemento se encuentra en cualquier otro estado, no ocurrirá nada.
Véase también state.
void cancel()
Cancela la descarga.
Si el elemento se encuentra en el estado DownloadInProgress, pasará al estado DownloadCancelled, se detendrá la descarga y se borrarán del disco los archivos parcialmente descargados.
Si el elemento se encuentra en el estado DownloadCompleted, no ocurrirá nada. Si el elemento se encuentra en cualquier otro estado, pasará al estado DownloadCancelled sin más consecuencias.
Véase también state.
void pause()
Detiene la descarga.
No tiene efecto si el estado no es DownloadInProgress. No cambia el estado.
Véase también resume y isPaused.
void resume()
Reanuda la descarga si se ha pausado o interrumpido.
No tiene efecto si el estado no es DownloadInProgress o DownloadInterrupted. No cambia el estado.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
