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, …, ResourceTypeUnknown }

公共函数

void	block (bool shouldBlock )
QUrl	firstPartyUrl () const
`(从 6.5 起)` QHash<QByteArray, QByteArray>	httpHeaders () const
QUrl	initiator () 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 )

详细描述

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::ResourceTypeWebSocket`	`254`	A WebSocket request. (Added in Qt 6.4)
`QWebEngineUrlRequestInfo::ResourceTypeUnknown`	`255`	未知请求类型。

注意： 为前向兼容应视为未知的所有不匹配值，而不仅仅是 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 (统一资源定位符)。

QWebEngineUrlRequestInfo::NavigationType QWebEngineUrlRequestInfo:: navigationType () const

返回请求的导航类型。

另请参阅 NavigationType .

void QWebEngineUrlRequestInfo:: redirect (const QUrl & url )

重定向此请求到 url 。只能重定向没有负载数据的请求，譬如：GET 请求。

`[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 为此请求。