QWebEngineUrlRequestInfo 類

The QWebEngineUrlRequestInfo class provides information about URL requests. 更多...

頭: #include <QWebEngineUrlRequestInfo>
Since: Qt 5.6

公共類型

enum NavigationType { NavigationTypeLink, NavigationTypeTyped, NavigationTypeFormSubmitted, NavigationTypeBackForward, NavigationTypeReload, NavigationTypeOther }
enum ResourceType { ResourceTypeMainFrame, ResourceTypeSubFrame, ResourceTypeStylesheet, ResourceTypeScript, ..., ResourceTypeUnknown }

公共函數

void block (bool shouldBlock )
QUrl firstPartyUrl () const
QWebEngineUrlRequestInfo::NavigationType navigationType () const
void redirect (const QUrl & url )
QByteArray requestMethod () const
QUrl requestUrl () const
QWebEngineUrlRequestInfo::ResourceType resourceType () const
void setHttpHeader (const QByteArray & name , const QByteArray & value )

詳細描述

The QWebEngineUrlRequestInfo class provides information about URL requests.

The QWebEngineUrlRequestInfo is useful for setting extra header fields for requests or for redirecting certain requests without payload data to another URL. This class cannot be instantiated or copied by the user, instead it will be created by Qt WebEngine and sent through the virtual function QWebEngineUrlRequestInterceptor::interceptRequest () 若攔截器有設置。

成員類型文檔編製

此枚舉類型描述請求的導航類型:

常量 描述
QWebEngineUrlRequestInfo::NavigationTypeLink 0 通過點擊鏈接初啓導航。
QWebEngineUrlRequestInfo::NavigationTypeTyped 1 通過鍵入 URL 明確初啓導航。
QWebEngineUrlRequestInfo::NavigationTypeFormSubmitted 2 提交錶單導航。
QWebEngineUrlRequestInfo::NavigationTypeBackForward 3 通過曆史動作初啓導航。
QWebEngineUrlRequestInfo::NavigationTypeReload 4 通過刷新頁麵初啓導航。
QWebEngineUrlRequestInfo::NavigationTypeOther 5 以上都不是。

enum QWebEngineUrlRequestInfo:: ResourceType

此枚舉類型保持請求資源的類型:

常量 描述
QWebEngineUrlRequestInfo::ResourceTypeMainFrame 0 頂層頁麵。
QWebEngineUrlRequestInfo::ResourceTypeSubFrame 1 框架或 iframe。
QWebEngineUrlRequestInfo::ResourceTypeStylesheet 2 CSS 樣式錶。
QWebEngineUrlRequestInfo::ResourceTypeScript 3 外部腳本。
QWebEngineUrlRequestInfo::ResourceTypeImage 4 圖像 (JPG、GIF、PNG、等等)。
QWebEngineUrlRequestInfo::ResourceTypeFontResource 5 字體。
QWebEngineUrlRequestInfo::ResourceTypeSubResource 6 Other 子資源。
QWebEngineUrlRequestInfo::ResourceTypeObject 7 插件請求的用於插件的對象 (或嵌入) 標簽或資源。
QWebEngineUrlRequestInfo::ResourceTypeMedia 8 媒體資源。
QWebEngineUrlRequestInfo::ResourceTypeWorker 9 專用工作者的主要資源。
QWebEngineUrlRequestInfo::ResourceTypeSharedWorker 10 共享工作者的主要資源。
QWebEngineUrlRequestInfo::ResourceTypePrefetch 11 明確請求的預抓取。
QWebEngineUrlRequestInfo::ResourceTypeFavicon 12 favicon。
QWebEngineUrlRequestInfo::ResourceTypeXhr 13 An XMLHttpRequest .
QWebEngineUrlRequestInfo::ResourceTypePing 14 用於 <ping> 的 ping 請求
QWebEngineUrlRequestInfo::ResourceTypeServiceWorker 15 服務工作者的主要資源。
QWebEngineUrlRequestInfo::ResourceTypeCspReport 16 違反 CSP (內容安全策略) 的報告。CSP 報告采用 JSON 格式,並通過 HTTP POST 請求把它們交付給指定服務器 (在 Qt 5.7 添加)。
QWebEngineUrlRequestInfo::ResourceTypePluginResource 17 由插件請求的資源 (在 Qt 5.7 添加)。
QWebEngineUrlRequestInfo::ResourceTypeUnknown 255 未知請求類型。

注意: 為前嚮兼容應視為未知的所有不匹配值,而不僅僅是 ResourceTypeUnknown .

成員函數文檔編製

void QWebEngineUrlRequestInfo:: block ( bool shouldBlock )

阻塞此請求若 shouldBlock 為 true,所以它不會繼續進行。

例如,可以使用此函數阻止從給定域導航齣去。

QUrl QWebEngineUrlRequestInfo:: firstPartyUrl () const

返迴請求的第 1 方 URL (統一資源定位符)。第 1 方 URL 是發齣請求頁麵的 URL。

返迴請求的導航類型。

另請參閱 NavigationType .

void QWebEngineUrlRequestInfo:: redirect (const QUrl & url )

重定嚮此請求到 url 。隻能重定嚮沒有負載數據的請求,譬如:GET 請求。

QByteArray QWebEngineUrlRequestInfo:: requestMethod () const

返迴請求的 HTTP 方法 (例如 GET 或 POST)。

QUrl QWebEngineUrlRequestInfo:: requestUrl () const

返迴請求的 URL (統一資源定位符)。

QWebEngineUrlRequestInfo::ResourceType QWebEngineUrlRequestInfo:: resourceType () const

返迴請求的資源類型。

另請參閱 ResourceType .

void QWebEngineUrlRequestInfo:: setHttpHeader (const QByteArray & name , const QByteArray & value )

設置請求頭 name to value 為此請求。