QWebEngineUrlRequestInfo 類

The QWebEngineUrlRequestInfo 類提供 URL 請求的有關信息。更多...

頭：	#include <QWebEngineUrlRequestInfo>
Since:	Qt 5.6

該類在 Qt 5.6 引入。

所有成員列錶，包括繼承成員

公共類型

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

公共函數

void	block (bool shouldBlock )
QUrl	firstPartyUrl () const
QUrl	initiator () 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 )

詳細描述

QWebEngineUrlRequestInfo 很有用，對於為請求設置額外 Header (頭) 字段，或將某些沒有負載數據的請求重定嚮到另一 URL (統一資源定位符)。用戶無法實例化 (或拷貝) 此類，相反，它由 Qt WebEngine 創建且發送透過虛函數 QWebEngineUrlRequestInterceptor::interceptRequest () 若攔截器有設置。

成員類型文檔編製

enum QWebEngineUrlRequestInfo:: NavigationType

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

常量	值	描述
`QWebEngineUrlRequestInfo::NavigationTypeLink`	`0`	通過點擊鏈接初啓導航。
`QWebEngineUrlRequestInfo::NavigationTypeTyped`	`1`	通過鍵入 URL 明確初啓導航。
`QWebEngineUrlRequestInfo::NavigationTypeFormSubmitted`	`2`	提交錶單導航。
`QWebEngineUrlRequestInfo::NavigationTypeBackForward`	`3`	通過曆史動作初啓導航。
`QWebEngineUrlRequestInfo::NavigationTypeReload`	`4`	通過刷新頁麵初啓導航。
`QWebEngineUrlRequestInfo::NavigationTypeRedirect`	`6`	通過頁麵內容 (或遠程服務器) 自動觸發導航 (在 Qt 5.14 添加)。
`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::ResourceTypeNavigationPreloadMainFrame`	`19`	主框架服務工作者導航預加載請求 (在 Qt 5.14 添加)。
`QWebEngineUrlRequestInfo::ResourceTypeNavigationPreloadSubFrame`	`20`	子架服務工作者導航預加載請求 (在 Qt 5.14 添加)。
`QWebEngineUrlRequestInfo::ResourceTypeUnknown`	`255`	未知請求類型。

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

成員函數文檔編製

void QWebEngineUrlRequestInfo:: block ( bool shouldBlock )

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

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

QUrl QWebEngineUrlRequestInfo:: firstPartyUrl () const

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

QUrl QWebEngineUrlRequestInfo:: initiator () const

返迴初啓框架導航到另一框架的文檔源 URL (統一資源定位符)。

該函數在 Qt 5.14 引入。

QWebEngineUrlRequestInfo::NavigationType QWebEngineUrlRequestInfo:: navigationType () const

返迴請求的導航類型。

另請參閱 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 為此請求。