class QWebEngineUrlRequestInfo

QWebEngineUrlRequestInfo 类提供了URL请求的信息。 更多...

概要

方法

• def block()

• 定义 changed()

• 定义 firstPartyUrl()

• 定义 httpHeaders()

• 定义 initiator()

• 定义 navigationType()

• 定义 redirect()

• 定义 requestBody()

• 定义 requestMethod()

• 定义 requestUrl()

• 定义 resourceType()

• 定义 setHttpHeader()

注意

本文档可能包含从 C++ 自动翻译到 Python 的片段。我们始终欢迎对片段翻译的贡献。如果您看到翻译问题，也可以通过在 https:/bugreports.qt.io_projects/PYSIDE 创建工单来告诉我们

详细描述

QWebEngineUrlRequestInfo 对设置请求的额外头字段或重定向某些不带有效负载数据的请求到另一个 URL 非常有用。此类不能由用户实例化或复制，而是由 Qt WebEngine 创建并通过虚拟函数 interceptRequest() 发送，如果设置了拦截器。

class ResourceType

此枚举类型包含请求资源的类型

常量	描述
QWebEngineUrlRequestInfo.ResourceTypeMainFrame	顶级页面。
QWebEngineUrlRequestInfo.ResourceTypeSubFrame	框架或iframe。
QWebEngineUrlRequestInfo.ResourceTypeStylesheet	CSS 样式表。
QWebEngineUrlRequestInfo.ResourceTypeScript	外部脚本。
QWebEngineUrlRequestInfo.ResourceTypeImage	图像（JPG，GIF，PNG 等）。
QWebEngineUrlRequestInfo.ResourceTypeFontResource	字体。
QWebEngineUrlRequestInfo.ResourceTypeSubResource	“其他”子资源。
QWebEngineUrlRequestInfo.ResourceTypeObject	插件或插件请求的资源（对象或embed）标签。
QWebEngineUrlRequestInfo.ResourceTypeMedia	媒体资源。
QWebEngineUrlRequestInfo.ResourceTypeWorker	专用工作线程的主要资源。
QWebEngineUrlRequestInfo.ResourceTypeSharedWorker	共享工作线程的主要资源。
QWebEngineUrlRequestInfo.ResourceTypePrefetch	明确定义的预加载请求。
QWebEngineUrlRequestInfo.ResourceTypeFavicon	网站图标。
QWebEngineUrlRequestInfo.ResourceTypeXhr	XMLHttpRequest。
QWebEngineUrlRequestInfo.ResourceTypePing	对于 <a ping> 的 ping 请求。
QWebEngineUrlRequestInfo.ResourceTypeServiceWorker	服务工作线程的主要资源。
QWebEngineUrlRequestInfo.ResourceTypeCspReport	内容安全策略（CSP）违规报告。CSP 报告以 JSON 格式存在，并通过 HTTP POST 请求发送到指定的服务器。自 Qt 5.7 以来添加。（Added in Qt 5.7）
QWebEngineUrlRequestInfo.ResourceTypePluginResource	插件请求的资源。自 Qt 5.7 以来添加。（Added in Qt 5.7）
QWebEngineUrlRequestInfo.ResourceTypeNavigationPreloadMainFrame	主框架服务工作线程导航预加载请求自 Qt 5.14 以来添加。（Added in Qt 5.14）
QWebEngineUrlRequestInfo.ResourceTypeNavigationPreloadSubFrame	子框架服务工作线程导航预加载请求自 Qt 5.14 以来添加。（Added in Qt 5.14）
QWebEngineUrlRequestInfo.ResourceTypeWebSocket	WebSocket 请求。自 Qt 6.4 以来添加。（Added in Qt 6.4）
QWebEngineUrlRequestInfo.ResourceTypeUnknown	未知请求类型。

注意

为了向前兼容，所有未匹配的值都应视为未知，而不仅仅是 ResourceTypeUnknown。

class NavigationType

此枚举类型描述了请求的导航类型

常量	描述
QWebEngineUrlRequestInfo.NavigationTypeLink	通过点击链接启动的导航。
QWebEngineUrlRequestInfo.NavigationTypeTyped	通过显式输入 URL 启动的导航。
QWebEngineUrlRequestInfo.NavigationTypeFormSubmitted	提交表单启动的导航。
QWebEngineUrlRequestInfo.NavigationTypeBackForward	通过历史记录操作启动的导航。
QWebEngineUrlRequestInfo.NavigationTypeReload	通过刷新页面启动的导航。
QWebEngineUrlRequestInfo.NavigationTypeRedirect	由页面内容或远程服务器自动触发的导航自 Qt 5.14 以来添加。（Added in Qt 5.14）
QWebEngineUrlRequestInfo.NavigationTypeOther	以上都不是。

block(shouldBlock)

参数：

shouldBlock – 布尔值

如果 shouldBlock 为 true，则阻塞此请求，使其不会继续。

此函数可用于防止离开特定域，例如。

changed()

返回类型：

布尔值

firstPartyUrl()

返回类型：

QUrl

返回请求的第一方 URL。第一方 URL 是发出请求的页面的 URL。

httpHeaders()

返回类型：

字典，键的类型为 QByteArray，值的类型为 QByteArray。

返回请求头。

注意

在此阶段，不是所有头都是可见的，因为 Chromium 会稍后添加安全和代理头。

initiator()

返回类型：

QUrl

返回发起窗口导航到另一个窗口的文档的源URL。

navigationType()

返回类型：

导航类型

返回请求的导航类型。

另请参阅

导航类型

redirect(url)

参数：

url - QUrl

将此请求重定向到 url。只有无有效载荷数据的请求（如GET请求）可以被重定向。

requestBody()

返回类型：

QIODevice

返回一个指向QIODevice的指针，提供对请求体的访问。当请求是POST请求时，请求体可以包含数据。如果请求体为空，QIODevice反映这一点，在对其进行读操作时不会返回任何数据。

requestMethod()

返回类型：

QByteArray

返回请求的HTTP方法（例如，GET或POST）。

requestUrl()

返回类型：

QUrl

返回请求的URL。

resourceType()

返回类型：

资源类型

返回请求的资源类型。

另请参阅

资源类型

setHttpHeader(name, value)

参数：

• name - QByteArray

• value - QByteArray

为此请求设置请求头 name 为 value。