QWebEngineUrlRequestInfo Class
La classe QWebEngineUrlRequestInfo fournit des informations sur les demandes d'URL. Plus d'informations...
| En-tête : | #include <QWebEngineUrlRequestInfo> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake : | QT += webenginecore |
Types publics
| enum | NavigationType { NavigationTypeLink, NavigationTypeTyped, NavigationTypeFormSubmitted, NavigationTypeBackForward, NavigationTypeReload, …, NavigationTypeOther } |
| enum | ResourceType { ResourceTypeMainFrame, ResourceTypeSubFrame, ResourceTypeStylesheet, ResourceTypeScript, ResourceTypeImage, …, ResourceTypeUnknown } |
Fonctions publiques
| 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) |
Description détaillée
La classe QWebEngineUrlRequestInfo est utile pour définir des champs d'en-tête supplémentaires pour les requêtes, ou pour rediriger certaines requêtes sans données utiles vers une autre URL. Cette classe ne peut pas être instanciée ou copiée par l'utilisateur ; à la place, elle sera créée par Qt WebEngine et envoyée par la fonction virtuelle QWebEngineUrlRequestInterceptor::interceptRequest() si un intercepteur a été défini.
Documentation des types de membres
enum QWebEngineUrlRequestInfo::NavigationType
Ce type d'énumération décrit le type de navigation de la demande :
| Constante | Valeur | Description du type de navigation |
|---|---|---|
QWebEngineUrlRequestInfo::NavigationTypeLink | 0 | Navigation initiée en cliquant sur un lien. |
QWebEngineUrlRequestInfo::NavigationTypeTyped | 1 | La navigation est explicitement initiée par la saisie d'une URL. |
QWebEngineUrlRequestInfo::NavigationTypeFormSubmitted | 2 | La navigation soumet un formulaire. |
QWebEngineUrlRequestInfo::NavigationTypeBackForward | 3 | Navigation initiée par une action de l'historique. |
QWebEngineUrlRequestInfo::NavigationTypeReload | 4 | Navigation initiée par le rafraîchissement de la page. |
QWebEngineUrlRequestInfo::NavigationTypeRedirect | 6 | [depuis 5.14] Navigation déclenchée automatiquement par le contenu de la page ou le serveur distant. |
QWebEngineUrlRequestInfo::NavigationTypeOther | 5 | Aucune de ces options. |
enum QWebEngineUrlRequestInfo::ResourceType
Ce type d'énumération contient le type de la ressource demandée :
| Constante | Valeur | Description de la ressource |
|---|---|---|
QWebEngineUrlRequestInfo::ResourceTypeMainFrame | 0 | Page de premier niveau. |
QWebEngineUrlRequestInfo::ResourceTypeSubFrame | 1 | Cadre ou iframe. |
QWebEngineUrlRequestInfo::ResourceTypeStylesheet | 2 | Une feuille de style CSS. |
QWebEngineUrlRequestInfo::ResourceTypeScript | 3 | Un script externe. |
QWebEngineUrlRequestInfo::ResourceTypeImage | 4 | Une image (JPG, GIF, PNG, etc.). |
QWebEngineUrlRequestInfo::ResourceTypeFontResource | 5 | Une police de caractères. |
QWebEngineUrlRequestInfo::ResourceTypeSubResource | 6 | Une sous-ressource "autre". |
QWebEngineUrlRequestInfo::ResourceTypeObject | 7 | Une balise objet (ou embed) pour un plugin ou une ressource demandée par un plugin. |
QWebEngineUrlRequestInfo::ResourceTypeMedia | 8 | Une ressource média. |
QWebEngineUrlRequestInfo::ResourceTypeWorker | 9 | La ressource principale d'un serveur dédié. |
QWebEngineUrlRequestInfo::ResourceTypeSharedWorker | 10 | La ressource principale d'un agent partagé. |
QWebEngineUrlRequestInfo::ResourceTypePrefetch | 11 | Un prefetch explicitement demandé. |
QWebEngineUrlRequestInfo::ResourceTypeFavicon | 12 | Une favicon. |
QWebEngineUrlRequestInfo::ResourceTypeXhr | 13 | Une demande XMLHttpRequest. |
QWebEngineUrlRequestInfo::ResourceTypePing | 14 | Une requête ping pour <a ping>. |
QWebEngineUrlRequestInfo::ResourceTypeServiceWorker | 15 | La ressource principale d'un agent de service. |
QWebEngineUrlRequestInfo::ResourceTypeCspReport (since Qt 5.7) | 16 | Un rapport sur les violations de la politique de sécurité du contenu (CSP). Les rapports CSP sont au format JSON et sont transmis par des requêtes HTTP POST aux serveurs spécifiés. |
QWebEngineUrlRequestInfo::ResourceTypePluginResource (since Qt 5.7) | 17 | Une ressource demandée par un plugin. |
QWebEngineUrlRequestInfo::ResourceTypeNavigationPreloadMainFrame (since Qt 5.14) | 19 | Une demande de préchargement de navigation d'un agent de service du cadre principal. |
QWebEngineUrlRequestInfo::ResourceTypeNavigationPreloadSubFrame (since Qt 5.14) | 20 | Une demande de préchargement de la navigation d'un agent de service de sous-cadre. |
QWebEngineUrlRequestInfo::ResourceTypeWebSocket (since Qt 6.4) | 254 | Une requête WebSocket. |
QWebEngineUrlRequestInfo::ResourceTypeJson (since Qt 6.9) | 21 | Un module JSON. |
QWebEngineUrlRequestInfo::ResourceTypeUnknown | 255 | Type de requête inconnu. |
Remarque : pour des raisons de compatibilité future, toutes les valeurs qui ne correspondent pas doivent être traitées comme inconnues, et pas seulement ResourceTypeUnknown.
Documentation des fonctions membres
void QWebEngineUrlRequestInfo::block(bool shouldBlock)
Bloque cette demande si shouldBlock est vrai, afin qu'elle ne soit pas traitée.
Cette fonction peut être utilisée pour empêcher la navigation hors d'un domaine donné, par exemple.
QUrl QWebEngineUrlRequestInfo::firstPartyUrl() const
Renvoie l'URL de première partie de la demande. L'URL de première partie est l'URL de la page qui a émis la demande.
[since 6.5] QHash<QByteArray, QByteArray> QWebEngineUrlRequestInfo::httpHeaders() const
Renvoie les en-têtes de la requête.
Remarque : tous les en-têtes ne sont pas visibles à ce stade, car Chromium ajoutera ultérieurement les en-têtes de sécurité et de proxy.
Cette fonction a été introduite dans Qt 6.5.
QUrl QWebEngineUrlRequestInfo::initiator() const
Renvoie l'URL d'origine du document qui a initié la navigation d'un cadre vers un autre cadre.
[since 6.9] bool QWebEngineUrlRequestInfo::isDownload() const
Retourne vrai si la demande a été initiée par une action de téléchargement explicite de la part de l'utilisateur.
Un téléchargement peut toujours avoir lieu, même si cette fonction renvoie un résultat faux.
Cette fonction a été introduite dans Qt 6.9.
QWebEngineUrlRequestInfo::NavigationType QWebEngineUrlRequestInfo::navigationType() const
Renvoie le type de navigation de la demande.
Voir aussi NavigationType.
void QWebEngineUrlRequestInfo::redirect(const QUrl &url)
Redirige cette demande vers url.
[since 6.7] QIODevice *QWebEngineUrlRequestInfo::requestBody() const
Renvoie un pointeur vers une adresse QIODevice qui donne accès au corps de la requête. Le corps de la requête peut contenir des données, par exemple lorsqu'il s'agit d'une requête POST. Si le corps de la requête est vide, le QIODevice le reflète et ne renvoie aucune donnée lorsqu'il est soumis à des opérations de lecture.
Cette fonction a été introduite dans Qt 6.7.
QByteArray QWebEngineUrlRequestInfo::requestMethod() const
Renvoie la méthode HTTP de la requête (par exemple, GET ou POST).
QUrl QWebEngineUrlRequestInfo::requestUrl() const
Renvoie l'URL demandée.
QWebEngineUrlRequestInfo::ResourceType QWebEngineUrlRequestInfo::resourceType() const
Renvoie le type de ressource de la demande.
Voir aussi ResourceType.
void QWebEngineUrlRequestInfo::setHttpHeader(const QByteArray &name, const QByteArray &value)
Définit l'en-tête de la demande name à value pour cette demande.
© 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.
