QWebEngineUrlRequestInfo Class
La clase QWebEngineUrlRequestInfo proporciona información sobre las peticiones URL. Más...
| Cabecera: | #include <QWebEngineUrlRequestInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
Tipos Públicos
| enum | NavigationType { NavigationTypeLink, NavigationTypeTyped, NavigationTypeFormSubmitted, NavigationTypeBackForward, NavigationTypeReload, …, NavigationTypeOther } |
| enum | ResourceType { ResourceTypeMainFrame, ResourceTypeSubFrame, ResourceTypeStylesheet, ResourceTypeScript, ResourceTypeImage, …, ResourceTypeUnknown } |
Funciones Públicas
| void | block(bool shouldBlock) |
| QUrl | firstPartyUrl() const |
(since 6.5) QHash<QByteArray, QByteArray> | httpHeaders() const |
| QUrl | initiator() const |
(since 6.9) bool | isDownload() const |
| QWebEngineUrlRequestInfo::NavigationType | navigationType() const |
| void | redirect(const QUrl &url) |
(since 6.7) QIODevice * | requestBody() const |
| QByteArray | requestMethod() const |
| QUrl | requestUrl() const |
| QWebEngineUrlRequestInfo::ResourceType | resourceType() const |
| void | setHttpHeader(const QByteArray &name, const QByteArray &value) |
Descripción Detallada
QWebEngineUrlRequestInfo es útil para establecer campos de cabecera adicionales para las peticiones, o para redirigir ciertas peticiones sin datos de carga útil a otra URL. Esta clase no puede ser instanciada o copiada por el usuario; en su lugar, será creada por Qt WebEngine y enviada a través de la función virtual QWebEngineUrlRequestInterceptor::interceptRequest() si se ha establecido un interceptor.
Documentación de tipos de miembros
enum QWebEngineUrlRequestInfo::NavigationType
Este tipo enum describe el tipo de navegación de la solicitud:
| Constante | Valor | Descripción |
|---|---|---|
QWebEngineUrlRequestInfo::NavigationTypeLink | 0 | Navegación iniciada haciendo clic en un enlace. |
QWebEngineUrlRequestInfo::NavigationTypeTyped | 1 | Navegación iniciada explícitamente tecleando una URL. |
QWebEngineUrlRequestInfo::NavigationTypeFormSubmitted | 2 | Navegación iniciada al enviar un formulario. |
QWebEngineUrlRequestInfo::NavigationTypeBackForward | 3 | Navegación iniciada por una acción del historial. |
QWebEngineUrlRequestInfo::NavigationTypeReload | 4 | Navegación iniciada al actualizar la página. |
QWebEngineUrlRequestInfo::NavigationTypeRedirect | 6 | [Navegación iniciada automáticamente por el contenido de la página o el servidor remoto. |
QWebEngineUrlRequestInfo::NavigationTypeOther | 5 | Ninguna de las anteriores. |
enum QWebEngineUrlRequestInfo::ResourceType
Este tipo enum contiene el tipo del recurso solicitado:
| Constante | Valor | Descripción |
|---|---|---|
QWebEngineUrlRequestInfo::ResourceTypeMainFrame | 0 | Página de nivel superior. |
QWebEngineUrlRequestInfo::ResourceTypeSubFrame | 1 | Marco o iframe. |
QWebEngineUrlRequestInfo::ResourceTypeStylesheet | 2 | Una hoja de estilos CSS. |
QWebEngineUrlRequestInfo::ResourceTypeScript | 3 | Un script externo. |
QWebEngineUrlRequestInfo::ResourceTypeImage | 4 | Una imagen (JPG, GIF, PNG, etc.). |
QWebEngineUrlRequestInfo::ResourceTypeFontResource | 5 | Una fuente. |
QWebEngineUrlRequestInfo::ResourceTypeSubResource | 6 | Un "otro" subrecurso. |
QWebEngineUrlRequestInfo::ResourceTypeObject | 7 | Una etiqueta objeto (o incrustada) para un plugin o un recurso solicitado por un plugin. |
QWebEngineUrlRequestInfo::ResourceTypeMedia | 8 | Un recurso multimedia. |
QWebEngineUrlRequestInfo::ResourceTypeWorker | 9 | El recurso principal de un trabajador dedicado. |
QWebEngineUrlRequestInfo::ResourceTypeSharedWorker | 10 | El recurso principal de un trabajador compartido. |
QWebEngineUrlRequestInfo::ResourceTypePrefetch | 11 | Un prefetch solicitado explícitamente. |
QWebEngineUrlRequestInfo::ResourceTypeFavicon | 12 | Un favicon. |
QWebEngineUrlRequestInfo::ResourceTypeXhr | 13 | Una solicitud XMLHttpRequest. |
QWebEngineUrlRequestInfo::ResourceTypePing | 14 | Una solicitud de ping para <a ping>. |
QWebEngineUrlRequestInfo::ResourceTypeServiceWorker | 15 | El recurso principal de un service worker. |
QWebEngineUrlRequestInfo::ResourceTypeCspReport (since Qt 5.7) | 16 | Un informe de infracciones de la política de seguridad de contenidos (CSP). Los informes CSP están en formato JSON y se entregan mediante solicitudes HTTP POST a servidores especificados. |
QWebEngineUrlRequestInfo::ResourceTypePluginResource (since Qt 5.7) | 17 | Un recurso solicitado por un plugin. |
QWebEngineUrlRequestInfo::ResourceTypeNavigationPreloadMainFrame (since Qt 5.14) | 19 | Una solicitud de precarga de navegación del trabajador de servicios de la estructura principal. |
QWebEngineUrlRequestInfo::ResourceTypeNavigationPreloadSubFrame (since Qt 5.14) | 20 | Una solicitud de precarga de navegación de un trabajador de servicios de subchasis. |
QWebEngineUrlRequestInfo::ResourceTypeWebSocket (since Qt 6.4) | 254 | Una solicitud WebSocket. |
QWebEngineUrlRequestInfo::ResourceTypeJson (since Qt 6.9) | 21 | Un módulo JSON. |
QWebEngineUrlRequestInfo::ResourceTypeUnknown | 255 | Tipo de solicitud desconocido. |
Nota: Por compatibilidad futura, todos los valores que no coincidan deben tratarse como desconocidos, no sólo ResourceTypeUnknown.
Documentación de las funciones miembro
void QWebEngineUrlRequestInfo::block(bool shouldBlock)
Bloquea esta petición si shouldBlock es verdadero, para que no proceda.
Esta función puede utilizarse para impedir la navegación fuera de un dominio determinado, por ejemplo.
QUrl QWebEngineUrlRequestInfo::firstPartyUrl() const
Devuelve la URL de la primera parte de la solicitud. La URL de origen es la URL de la página que emitió la solicitud.
[since 6.5] QHash<QByteArray, QByteArray> QWebEngineUrlRequestInfo::httpHeaders() const
Devuelve las cabeceras de la petición.
Nota: No todas las cabeceras son visibles en este momento, ya que Chromium añadirá cabeceras de seguridad y proxy más adelante.
Esta función se introdujo en Qt 6.5.
QUrl QWebEngineUrlRequestInfo::initiator() const
Devuelve la URL de origen del documento que inició la navegación de un marco a otro marco.
[since 6.9] bool QWebEngineUrlRequestInfo::isDownload() const
Devuelve true si la solicitud fue iniciada por una acción de descarga explícita del usuario.
Una descarga todavía puede ocurrir, incluso cuando esta función devuelva false.
Esta función se introdujo en Qt 6.9.
QWebEngineUrlRequestInfo::NavigationType QWebEngineUrlRequestInfo::navigationType() const
Devuelve el tipo de navegación de la solicitud.
Véase también NavigationType.
void QWebEngineUrlRequestInfo::redirect(const QUrl &url)
Redirige esta petición a url.
[since 6.7] QIODevice *QWebEngineUrlRequestInfo::requestBody() const
Devuelve un puntero a QIODevice que da acceso al cuerpo de la petición. El cuerpo de la petición puede contener datos, por ejemplo, cuando la petición es una petición POST. Si el cuerpo de la petición está vacío, QIODevice lo refleja y no devuelve ningún dato al realizar operaciones de lectura sobre él.
Esta función se introdujo en Qt 6.7.
QByteArray QWebEngineUrlRequestInfo::requestMethod() const
Devuelve el método HTTP de la solicitud (por ejemplo, GET o POST).
QUrl QWebEngineUrlRequestInfo::requestUrl() const
Devuelve la URL solicitada.
QWebEngineUrlRequestInfo::ResourceType QWebEngineUrlRequestInfo::resourceType() const
Devuelve el tipo de recurso de la solicitud.
Véase también ResourceType.
void QWebEngineUrlRequestInfo::setHttpHeader(const QByteArray &name, const QByteArray &value)
Establece la cabecera de la solicitud name a value para esta solicitud.
© 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.
