QWebEngineUrlRequestInfo Class

QWebEngineUrlRequestInfo クラスは URL リクエストに関する情報を提供します。詳細...

Header: #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, …, ResourceTypeJson }

パブリック関数

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() を通して送信されます。

メンバ型の説明

この列挙型は、リクエストのナビゲーションタイプを記述します:

定数説明
QWebEngineUrlRequestInfo::NavigationTypeLink0リンクをクリックすることで開始されるナビゲーション。
QWebEngineUrlRequestInfo::NavigationTypeTyped1URLの入力によって明示的に開始されるナビゲーション。
QWebEngineUrlRequestInfo::NavigationTypeFormSubmitted2ナビゲーションはフォームを送信します。
QWebEngineUrlRequestInfo::NavigationTypeBackForward3履歴アクションによって開始されたナビゲーション。
QWebEngineUrlRequestInfo::NavigationTypeReload4ページの更新によって開始されるナビゲーション。
QWebEngineUrlRequestInfo::NavigationTypeRedirect6ページのコンテンツやリモートサーバーによって自動的に開始されるナビゲーション。(Qt 5.14 で追加)
QWebEngineUrlRequestInfo::NavigationTypeOther5上記のどれでもない。

enum QWebEngineUrlRequestInfo::ResourceType

この列挙型は、要求されたリソースのタイプを保持します:

定数説明
QWebEngineUrlRequestInfo::ResourceTypeMainFrame0トップレベルページ。
QWebEngineUrlRequestInfo::ResourceTypeSubFrame1フレームまたは iframe。
QWebEngineUrlRequestInfo::ResourceTypeStylesheet2CSSスタイルシート
QWebEngineUrlRequestInfo::ResourceTypeScript3外部スクリプト
QWebEngineUrlRequestInfo::ResourceTypeImage4画像(JPG、GIF、PNGなど)
QWebEngineUrlRequestInfo::ResourceTypeFontResource5フォント
QWebEngineUrlRequestInfo::ResourceTypeSubResource6その他」サブリソース
QWebEngineUrlRequestInfo::ResourceTypeObject7プラグインのオブジェクト(または埋め込み)タグ、またはプラグインが要求したリソース
QWebEngineUrlRequestInfo::ResourceTypeMedia8メディアリソース。
QWebEngineUrlRequestInfo::ResourceTypeWorker9専用ワーカーのメインリソース
QWebEngineUrlRequestInfo::ResourceTypeSharedWorker10共有ワーカーのメインリソース
QWebEngineUrlRequestInfo::ResourceTypePrefetch11明示的にリクエストされたプリフェッチ
QWebEngineUrlRequestInfo::ResourceTypeFavicon12ファビコン。
QWebEngineUrlRequestInfo::ResourceTypeXhr13XMLHttpRequest
QWebEngineUrlRequestInfo::ResourceTypePing14<a ping> に対する ping リクエスト。
QWebEngineUrlRequestInfo::ResourceTypeServiceWorker15サービスワーカーのメインリソース。
QWebEngineUrlRequestInfo::ResourceTypeCspReport16コンテンツ・セキュリティ・ポリシー(CSP)違反のレポート。CSP レポートは JSON 形式で、指定したサーバーに HTTP POST リクエストで配信されます。(Qt 5.7 で追加されました)
QWebEngineUrlRequestInfo::ResourceTypePluginResource17プラグインが要求するリソース。(Qt 5.7 で追加)。
QWebEngineUrlRequestInfo::ResourceTypeNavigationPreloadMainFrame19本体サービスワーカーのナビゲーションのプリロード要求。(Qt 5.14 で追加)。
QWebEngineUrlRequestInfo::ResourceTypeNavigationPreloadSubFrame20サブフレームサービスワーカーのナビゲーションのプリロード要求。(Qt 5.14 で追加)。
QWebEngineUrlRequestInfo::ResourceTypeWebSocket254WebSocket リクエスト。(Qt 6.4 で追加)。
QWebEngineUrlRequestInfo::ResourceTypeUnknown255不明なリクエストタイプ。
QWebEngineUrlRequestInfo::ResourceTypeJson21JSON モジュール。(Qt 6.8 で追加)

注意: 前方互換性のために、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 を返します。

リクエストのナビゲーションタイプを返します。

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 メソッド リクエストの HTTP メソッド(例えば、GET または POST)を返します。

QUrl QWebEngineUrlRequestInfo::requestUrl() const

リクエストされた URL を返します。

QWebEngineUrlRequestInfo::ResourceType QWebEngineUrlRequestInfo::resourceType() const

リクエストのリソースタイプを返します。

ResourceTypeも参照してください

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

このリクエストのリクエストヘッダnamevalue に設定します。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。