QWebEngineUrlRequestInfo Class
QWebEngineUrlRequestInfo クラスは URL リクエストに関する情報を提供します。詳細...
| ヘッダ | #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() を通して送信されます。
メンバ型ドキュメント
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 | 上記のどれでもありません。 |
enum 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 | ファビコン。 |
QWebEngineUrlRequestInfo::ResourceTypeXhr | 13 | XMLHttpRequest 。 |
QWebEngineUrlRequestInfo::ResourceTypePing | 14 | <a 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 | 不明なリクエストタイプ。 |
QWebEngineUrlRequestInfo::ResourceTypeJson | 21 | JSON モジュール。(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 を返します。
QWebEngineUrlRequestInfo::NavigationType QWebEngineUrlRequestInfo::navigationType() const
リクエストのナビゲーションタイプを返す。
NavigationTypeも参照してください 。
void QWebEngineUrlRequestInfo::redirect(const QUrl &url)
このリクエストをurl にリダイレクトする。
[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 に設定する。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
