QWebEngineUrlRequestInfo Class

QWebEngineUrlRequestInfo class provides information about URL requests. 更多...

Header: #include <QWebEngineUrlRequestInfo>
Since: Qt 5.6

公共类型

enum NavigationType { NavigationTypeLink, NavigationTypeTyped, NavigationTypeFormSubmitted, NavigationTypeBackForward, NavigationTypeReload, NavigationTypeOther }
enum ResourceType { ResourceTypeMainFrame, ResourceTypeSubFrame, ResourceTypeStylesheet, ResourceTypeScript, ..., ResourceTypeUnknown }

公共函数

void block (bool shouldBlock )
QUrl firstPartyUrl () const
QWebEngineUrlRequestInfo::NavigationType navigationType () const
void redirect (const QUrl & url )
QByteArray requestMethod () const
QUrl requestUrl () const
QWebEngineUrlRequestInfo::ResourceType resourceType () const
void setHttpHeader (const QByteArray & name , const QByteArray & value )

详细描述

QWebEngineUrlRequestInfo class provides information about URL requests.

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 () if an interceptor has been set.

成员类型文档编制

This enum type describes the navigation type of the request:

常量 描述
QWebEngineUrlRequestInfo::NavigationTypeLink 0 Navigation initiated by clicking a link.
QWebEngineUrlRequestInfo::NavigationTypeTyped 1 Navigation explicitly initiated by typing a URL.
QWebEngineUrlRequestInfo::NavigationTypeFormSubmitted 2 Navigation submits a form.
QWebEngineUrlRequestInfo::NavigationTypeBackForward 3 Navigation initiated by a history action.
QWebEngineUrlRequestInfo::NavigationTypeReload 4 Navigation initiated by refreshing the page.
QWebEngineUrlRequestInfo::NavigationTypeOther 5 None of the above.

enum QWebEngineUrlRequestInfo:: ResourceType

This enum type holds the type of the requested resource:

常量 描述
QWebEngineUrlRequestInfo::ResourceTypeMainFrame 0 Top level page.
QWebEngineUrlRequestInfo::ResourceTypeSubFrame 1 Frame or iframe.
QWebEngineUrlRequestInfo::ResourceTypeStylesheet 2 A CSS stylesheet.
QWebEngineUrlRequestInfo::ResourceTypeScript 3 An external script.
QWebEngineUrlRequestInfo::ResourceTypeImage 4 An image (JPG, GIF, PNG, and so on).
QWebEngineUrlRequestInfo::ResourceTypeFontResource 5 A font.
QWebEngineUrlRequestInfo::ResourceTypeSubResource 6 An "other" subresource.
QWebEngineUrlRequestInfo::ResourceTypeObject 7 An object (or embed) tag for a plugin or a resource that a plugin requested.
QWebEngineUrlRequestInfo::ResourceTypeMedia 8 A media resource.
QWebEngineUrlRequestInfo::ResourceTypeWorker 9 The main resource of a dedicated worker.
QWebEngineUrlRequestInfo::ResourceTypeSharedWorker 10 The main resource of a shared worker.
QWebEngineUrlRequestInfo::ResourceTypePrefetch 11 An explicitly requested prefetch.
QWebEngineUrlRequestInfo::ResourceTypeFavicon 12 A favicon.
QWebEngineUrlRequestInfo::ResourceTypeXhr 13 An XMLHttpRequest .
QWebEngineUrlRequestInfo::ResourceTypePing 14 A ping request for <a ping>.
QWebEngineUrlRequestInfo::ResourceTypeServiceWorker 15 The main resource of a service worker.
QWebEngineUrlRequestInfo::ResourceTypeCspReport 16 A report of Content Security Policy (CSP) violations. CSP reports are in JSON format and they are delivered by HTTP POST requests to specified servers. (Added in Qt 5.7)
QWebEngineUrlRequestInfo::ResourceTypePluginResource 17 A resource requested by a plugin. (Added in Qt 5.7)
QWebEngineUrlRequestInfo::ResourceTypeUnknown 255 Unknown request type.

注意: For forward compatibility all values not matched should be treated as unknown, not just ResourceTypeUnknown .

成员函数文档编制

void QWebEngineUrlRequestInfo:: block ( bool shouldBlock )

Blocks this request if shouldBlock is true, so that it will not proceed.

This function can be used to prevent navigating away from a given domain, for example.

QUrl QWebEngineUrlRequestInfo:: firstPartyUrl () const

Returns the first party URL of the request. The first party URL is the URL of the page that issued the request.

Returns the navigation type of the request.

另请参阅 NavigationType .

void QWebEngineUrlRequestInfo:: redirect (const QUrl & url )

Redirects this request to url . It is only possible to redirect requests that do not have payload data, such as GET requests.

QByteArray QWebEngineUrlRequestInfo:: requestMethod () const

Returns the HTTP method of the request (for example, GET or POST).

QUrl QWebEngineUrlRequestInfo:: requestUrl () const

Returns the requested URL.

QWebEngineUrlRequestInfo::ResourceType QWebEngineUrlRequestInfo:: resourceType () const

Returns the resource type of the request.

另请参阅 ResourceType .

void QWebEngineUrlRequestInfo:: setHttpHeader (const QByteArray & name , const QByteArray & value )

Sets the request header name to value for this request.