PySide6.QtWebEngineCore.QWebEngineUrlRequestInfo¶

class QWebEngineUrlRequestInfo¶

QWebEngineUrlRequestInfo 类提供了关于URL请求的信息。更多…

概要¶

方法¶

• def block()

• def changed()

• def firstPartyUrl()

• def httpHeaders()

• def initiator()

• def navigationType()

• def redirect()

• def requestBody()

• def requestMethod()

• def requestUrl()

• def resourceType()

• def 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	插件或插件请求的资源的对象（或嵌入）标签。
QWebEngineUrlRequestInfo.ResourceTypeMedia	一个媒体资源。
QWebEngineUrlRequestInfo.ResourceTypeWorker	专用工作线程的主要资源。
QWebEngineUrlRequestInfo.ResourceTypeSharedWorker	共享工作线程的主资源。
QWebEngineUrlRequestInfo.ResourceTypePrefetch	明确请求的预取。
QWebEngineUrlRequestInfo.ResourceTypeFavicon	一个网站图标。
QWebEngineUrlRequestInfo.ResourceTypeXhr	一个XMLHttpRequest。
QWebEngineUrlRequestInfo.ResourceTypePing	一个用于 的 ping 请求。
QWebEngineUrlRequestInfo.ResourceTypeServiceWorker	服务工作线程的主要资源。
QWebEngineUrlRequestInfo.ResourceTypeCspReport	内容安全策略（CSP）违规的报告。CSP报告以JSON格式提供，并通过HTTP POST请求发送到指定的服务器。（在Qt 5.7中添加）
QWebEngineUrlRequestInfo.ResourceTypePluginResource	插件请求的资源。（在Qt 5.7中添加）
QWebEngineUrlRequestInfo.ResourceTypeNavigationPreloadMainFrame	主框架服务工作者导航预加载请求。（在Qt 5.14中添加）
QWebEngineUrlRequestInfo.ResourceTypeNavigationPreloadSubFrame	一个子框架服务工作者导航预加载请求。（在Qt 5.14中添加）
QWebEngineUrlRequestInfo.ResourceTypeWebSocket	一个WebSocket请求。（在Qt 6.4中添加）
QWebEngineUrlRequestInfo.ResourceTypeUnknown	未知的请求类型。
QWebEngineUrlRequestInfo.ResourceTypeJson	一个JSON模块。（在Qt 6.8中添加）

注意

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

class NavigationType¶

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

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

block(shouldBlock)¶

Parameters:

shouldBlock – 布尔值

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

此函数可用于防止从给定域导航离开，例如。

changed()¶

Return type:

布尔

firstPartyUrl()¶

Return type:

QUrl

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

httpHeaders()¶

Return type:

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

返回请求头。

注意

并非所有头部信息在此阶段都可见，因为Chromium将在后续阶段添加安全和代理头部信息。

initiator()¶

Return type:

QUrl

返回启动框架导航到另一个框架的文档的原始URL。

navigationType()¶

Return type:

NavigationType

返回请求的导航类型。

另请参阅

NavigationType

redirect(url)¶

Parameters:

url – QUrl

将此请求重定向到 url。

requestBody()¶

Return type:

QIODevice

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

requestMethod()¶

Return type:

QByteArray

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

requestUrl()¶

Return type:

QUrl

返回请求的URL。

resourceType()¶

Return type:

ResourceType

返回请求的资源类型。

另请参阅

ResourceType

setHttpHeader(name, value)¶

Parameters:

• name – QByteArray

• value – QByteArray

将请求头 name 设置为 value 用于此请求。