QWebEngineUrlRequestInfo 类
QWebEngineUrlRequestInfo 类提供有关 URL 请求的信息。 更多...
| 头文件 | #include <QWebEngineUrlRequestInfo> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore) target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake | QT += webenginecore |
公开类型
| 枚举 | NavigationType { NavigationTypeLink, NavigationTypeTyped, NavigationTypeFormSubmitted, NavigationTypeBackForward, NavigationTypeReload, …, NavigationTypeOther } |
| 枚举 | ResourceType { ResourceTypeMainFrame, ResourceTypeSubFrame, ResourceTypeStylesheet, ResourceTypeScript, ResourceTypeImage, …, ResourceTypeUnknown } |
公开函数
| void | block(bool shouldBlock) |
| QUrl | firstPartyUrl() const |
(since 6.5) QHash<QByteArray, QByteArray> | httpHeaders() const |
| QUrl | initiator() const |
| QWebEngineUrlRequestInfo::NavigationType | navigationType() const |
| void | redirect(const QUrl &url) |
(since 6.7) QIODevice * | requestBody() const |
| QByteArray | requestMethod() const |
| QUrl | requestUrl() const |
| QWebEngineUrlRequestInfo::ResourceType | resourceType() const |
| void | setHttpHeader(const QByteArray &name, const QByteArray &value) |
详细说明
QWebEngineUrlRequestInfo 对设置请求的额外头部字段或重定向某些不携带有效负载数据的请求到另一个 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 | 以上皆非。 |
枚举 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 | 一个“其他”子资源。 |
QWebEngineUrlRequestInfo::ResourceTypeObject | 7 | 一个插件或插件请求的资源（或嵌入）标记。 |
QWebEngineUrlRequestInfo::ResourceTypeMedia | 8 | 一个媒体资源。 |
QWebEngineUrlRequestInfo::ResourceTypeWorker | 9 | 专门工作器的主体资源。 |
QWebEngineUrlRequestInfo::ResourceTypeSharedWorker | 10 | 共享工作器的主体资源。 |
QWebEngineUrlRequestInfo::ResourceTypePrefetch | 11 | 一个显式请求的预取。 |
QWebEngineUrlRequestInfo::ResourceTypeFavicon | 12 | 一个favicon。 |
QWebEngineUrlRequestInfo::ResourceTypeXhr | 13 | 一个< Spare href="qml-qtqml-xmlhttprequest.html" translate="no">XMLHttpRequest。 |
QWebEngineUrlRequestInfo::ResourceTypePing | 14 | 对 < Spare 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 | 一个WebSocket请求。（自 Qt 6.4 开始添加） |
QWebEngineUrlRequestInfo::ResourceTypeUnknown | 255 | 未知请求类型。 |
注意： 为了前后兼容性，所有不匹配的值都应被视为未知，而不仅仅是 ResourceTypeUnknown。
成员函数文档
void QWebEngineUrlRequestInfo::block(bool shouldBlock)
如果 shouldBlock 为true，则阻止此请求，使其不会进行。
此函数可用于防止从给定域名导航离开，例如。
QUrl QWebEngineUrlRequestInfo::firstPartyUrl() const
返回请求的第一方URL。第一方URL是发出请求的页面的URL。
[since 6.5] QHash<QByteArray, QByteArray> QWebEngineUrlRequestInfo::httpHeaders() const
返回请求头。
注意： 在此阶段并非所有头都可见，因为Chromium将在稍后阶段添加安全性和代理头。
此函数是在 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的指针，该指针提供对请求正文的访问。请求正文可以包含数据，例如当请求是POST请求时。如果请求正文为空，QIODevice会反映这一点，并在对其进行读取操作时不会返回任何数据。
此功能是在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为value。
© 2024 Qt公司有限公司。此处包含的文档贡献是各自所有者的版权。此处提供的文档是根据自由软件基金会发布的GNU自由文档许可证第1.3版的条款许可的。Qt及其相关标志是芬兰以及/或其他国家和地区Qt公司有限公司的商标。所有其他商标均为其各自所有者的财产。
