QWebEngineUrlRequestInfo Class
Die Klasse QWebEngineUrlRequestInfo liefert Informationen über URL-Anfragen. Mehr...
| Kopfzeile: | #include <QWebEngineUrlRequestInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
Öffentliche Typen
| enum | NavigationType { NavigationTypeLink, NavigationTypeTyped, NavigationTypeFormSubmitted, NavigationTypeBackForward, NavigationTypeReload, …, NavigationTypeOther } |
| enum | ResourceType { ResourceTypeMainFrame, ResourceTypeSubFrame, ResourceTypeStylesheet, ResourceTypeScript, ResourceTypeImage, …, ResourceTypeJson } |
Öffentliche Funktionen
| void | block(bool shouldBlock) |
| QUrl | firstPartyUrl() const |
(since 6.5) QHash<QByteArray, QByteArray> | httpHeaders() const |
| QUrl | initiator() 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) |
Detaillierte Beschreibung
Die QWebEngineUrlRequestInfo ist nützlich, um zusätzliche Header-Felder für Anfragen zu setzen oder um bestimmte Anfragen ohne Nutzdaten an eine andere URL umzuleiten. Diese Klasse kann nicht vom Benutzer instanziiert oder kopiert werden, stattdessen wird sie von Qt WebEngine erstellt und durch die virtuelle Funktion QWebEngineUrlRequestInterceptor::interceptRequest() gesendet, wenn ein Interceptor gesetzt wurde.
Dokumentation der Mitgliedstypen
enum QWebEngineUrlRequestInfo::NavigationType
Dieser Enum-Typ beschreibt den Navigationstyp der Anfrage:
| Konstante | Wert | Beschreibung |
|---|---|---|
QWebEngineUrlRequestInfo::NavigationTypeLink | 0 | Navigation, die durch Anklicken eines Links eingeleitet wird. |
QWebEngineUrlRequestInfo::NavigationTypeTyped | 1 | Die Navigation wird explizit durch die Eingabe einer URL eingeleitet. |
QWebEngineUrlRequestInfo::NavigationTypeFormSubmitted | 2 | Navigation schickt ein Formular ab. |
QWebEngineUrlRequestInfo::NavigationTypeBackForward | 3 | Navigation, die durch eine Verlaufsaktion eingeleitet wird. |
QWebEngineUrlRequestInfo::NavigationTypeReload | 4 | Navigation wird durch Aktualisieren der Seite ausgelöst. |
QWebEngineUrlRequestInfo::NavigationTypeRedirect | 6 | Die Navigation wird automatisch durch den Seiteninhalt oder einen entfernten Server ausgelöst. (Hinzugefügt in Qt 5.14) |
QWebEngineUrlRequestInfo::NavigationTypeOther | 5 | Keine der oben genannten Möglichkeiten. |
enum QWebEngineUrlRequestInfo::ResourceType
Dieser Enum-Typ enthält den Typ der angeforderten Ressource:
| Konstante | Wert | Beschreibung |
|---|---|---|
QWebEngineUrlRequestInfo::ResourceTypeMainFrame | 0 | Seite der obersten Ebene. |
QWebEngineUrlRequestInfo::ResourceTypeSubFrame | 1 | Frame oder iframe. |
QWebEngineUrlRequestInfo::ResourceTypeStylesheet | 2 | Ein CSS-Stylesheet. |
QWebEngineUrlRequestInfo::ResourceTypeScript | 3 | Ein externes Skript. |
QWebEngineUrlRequestInfo::ResourceTypeImage | 4 | Ein Bild (JPG, GIF, PNG, usw.). |
QWebEngineUrlRequestInfo::ResourceTypeFontResource | 5 | Eine Schriftart. |
QWebEngineUrlRequestInfo::ResourceTypeSubResource | 6 | Eine "andere" Subresource. |
QWebEngineUrlRequestInfo::ResourceTypeObject | 7 | Ein Objekt- (oder Einbettungs-) Tag für ein Plugin oder eine Ressource, die ein Plugin angefordert hat. |
QWebEngineUrlRequestInfo::ResourceTypeMedia | 8 | Eine Medienressource. |
QWebEngineUrlRequestInfo::ResourceTypeWorker | 9 | Die Hauptressource eines dedizierten Workers. |
QWebEngineUrlRequestInfo::ResourceTypeSharedWorker | 10 | Die Hauptressource eines Shared Workers. |
QWebEngineUrlRequestInfo::ResourceTypePrefetch | 11 | Ein explizit angeforderter Prefetch. |
QWebEngineUrlRequestInfo::ResourceTypeFavicon | 12 | Ein Favicon. |
QWebEngineUrlRequestInfo::ResourceTypeXhr | 13 | Ein XMLHttpRequest. |
QWebEngineUrlRequestInfo::ResourceTypePing | 14 | Eine Ping-Anforderung für <a ping>. |
QWebEngineUrlRequestInfo::ResourceTypeServiceWorker | 15 | Die Hauptressource eines Service Workers. |
QWebEngineUrlRequestInfo::ResourceTypeCspReport | 16 | Ein Bericht über Verstöße gegen die Content Security Policy (CSP). CSP-Berichte liegen im JSON-Format vor und werden durch HTTP-POST-Anfragen an bestimmte Server übermittelt. (Hinzugefügt in Qt 5.7) |
QWebEngineUrlRequestInfo::ResourceTypePluginResource | 17 | Eine von einem Plugin angeforderte Ressource. (Hinzugefügt in Qt 5.7) |
QWebEngineUrlRequestInfo::ResourceTypeNavigationPreloadMainFrame | 19 | Eine Main-Frame-Service-Worker-Anforderung zum Vorladen der Navigation. (Hinzugefügt in Qt 5.14) |
QWebEngineUrlRequestInfo::ResourceTypeNavigationPreloadSubFrame | 20 | Eine Sub-Frame-Service-Worker-Anforderung zum Vorladen der Navigation. (Hinzugefügt in Qt 5.14) |
QWebEngineUrlRequestInfo::ResourceTypeWebSocket | 254 | Eine WebSocket-Anfrage. (Hinzugefügt in Qt 6.4) |
QWebEngineUrlRequestInfo::ResourceTypeUnknown | 255 | Unbekannter Anfragetyp. |
QWebEngineUrlRequestInfo::ResourceTypeJson | 21 | Ein JSON-Modul. (Hinzugefügt in Qt 6.8) |
Hinweis: Aus Gründen der Vorwärtskompatibilität sollten alle nicht übereinstimmenden Werte als unbekannt behandelt werden, nicht nur ResourceTypeUnknown.
Dokumentation der Mitgliedsfunktionen
void QWebEngineUrlRequestInfo::block(bool shouldBlock)
Blockiert diese Anfrage, wenn shouldBlock wahr ist, so dass sie nicht fortgesetzt wird.
Diese Funktion kann z. B. verwendet werden, um zu verhindern, dass von einer bestimmten Domäne weg navigiert wird.
QUrl QWebEngineUrlRequestInfo::firstPartyUrl() const
Gibt die URL der ersten Partei der Anfrage zurück. Die Erstanbieter-URL ist die URL der Seite, die die Anfrage gestellt hat.
[since 6.5] QHash<QByteArray, QByteArray> QWebEngineUrlRequestInfo::httpHeaders() const
Gibt die Header der Anfrage zurück.
Hinweis: Zu diesem Zeitpunkt sind nicht alle Header sichtbar, da Chromium zu einem späteren Zeitpunkt Sicherheits- und Proxy-Header hinzufügen wird.
Diese Funktion wurde in Qt 6.5 eingeführt.
QUrl QWebEngineUrlRequestInfo::initiator() const
Gibt die Ursprungs-URL des Dokuments zurück, das die Navigation von einem Frame zu einem anderen Frame ausgelöst hat.
QWebEngineUrlRequestInfo::NavigationType QWebEngineUrlRequestInfo::navigationType() const
Gibt den Navigationstyp der Anfrage zurück.
Siehe auch NavigationType.
void QWebEngineUrlRequestInfo::redirect(const QUrl &url)
Leitet diese Anfrage an url weiter.
[since 6.7] QIODevice *QWebEngineUrlRequestInfo::requestBody() const
Gibt einen Zeiger auf eine QIODevice zurück, die den Zugriff auf den Request Body ermöglicht. Der Request Body kann Daten enthalten, wenn es sich beispielsweise um eine POST-Anfrage handelt. Wenn der Request Body leer ist, reflektiert QIODevice dies und gibt keine Daten zurück, wenn Leseoperationen darauf ausgeführt werden.
Diese Funktion wurde in Qt 6.7 eingeführt.
QByteArray QWebEngineUrlRequestInfo::requestMethod() const
Gibt die HTTP-Methode der Anfrage zurück (z. B. GET oder POST).
QUrl QWebEngineUrlRequestInfo::requestUrl() const
Gibt die angeforderte URL zurück.
QWebEngineUrlRequestInfo::ResourceType QWebEngineUrlRequestInfo::resourceType() const
Gibt den Ressourcentyp der Anfrage zurück.
Siehe auch ResourceType.
void QWebEngineUrlRequestInfo::setHttpHeader(const QByteArray &name, const QByteArray &value)
Setzt den Anfragekopf name für diese Anfrage auf value.
© 2025 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.
