QWebEngineUrlRequestInfo 類

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

頭：	`#include <QWebEngineUrlRequestInfo>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)` `target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)`
qmake:	`QT += webenginecore`

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

公共類型

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

公共函數

void	block (bool shouldBlock )
QUrl	firstPartyUrl () const
`(從 6.5 起)` QHash<QByteArray, QByteArray>	httpHeaders () const
QUrl	initiator () const
`(從 6.9 起)` bool	isDownload () const
QWebEngineUrlRequestInfo::NavigationType	navigationType () const
void	redirect (const QUrl & url )
`(從 6.7 起)` QIODevice *	requestBody () const
QByteArray	requestMethod () const
QUrl	requestUrl () const
QWebEngineUrlRequestInfo::ResourceType	resourceType () const
void	setHttpHeader (const QByteArray & name , const QByteArray & value )

詳細描述

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 () 若攔截器有設置。

成員類型文檔編製

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::ResourceTypeWebSocket`	`254`	A WebSocket request. (Added in Qt 6.4)
`QWebEngineUrlRequestInfo::ResourceTypeUnknown`	`255`	未知請求類型。
`QWebEngineUrlRequestInfo::ResourceTypeJson`	`21`	A JSON module. (Added in Qt 6.8)

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

成員函數文檔編製

void QWebEngineUrlRequestInfo:: block ( bool shouldBlock )

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

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

QUrl QWebEngineUrlRequestInfo:: firstPartyUrl () const

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

`[since 6.5]` QHash < QByteArray , QByteArray > QWebEngineUrlRequestInfo:: httpHeaders () const

Returns the request headers.

注意： Not all headers are visible at this stage as Chromium will add security and proxy headers at a later stage.

該函數在 Qt 6.5 引入。

QUrl QWebEngineUrlRequestInfo:: initiator () const

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

`[since 6.9]` bool QWebEngineUrlRequestInfo:: isDownload () const

Returns true if the request was initiated by an explicit download action from the user.

A download can still occurs, even when this function return false.

該函數在 Qt 6.9 引入。

QWebEngineUrlRequestInfo::NavigationType QWebEngineUrlRequestInfo:: navigationType () const

返迴請求的導航類型。

另請參閱 NavigationType .

void QWebEngineUrlRequestInfo:: redirect (const QUrl & url )

重定嚮此請求到 url .

`[since 6.7]` QIODevice *QWebEngineUrlRequestInfo:: requestBody () const

返迴指針指嚮 QIODevice that gives access to the request body. The request body can contain data for example when the request is a POST request. If the request body is empty, the QIODevice reflects this and does not return any data when performing read operations on it.

該函數在 Qt 6.7 引入。

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