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, …, ResourceTypeUnknown } |
パブリック関数
| void | block(bool shouldBlock) |
| QUrl | firstPartyUrl() const |
(since 6.5) QHash<QByteArray, QByteArray> | httpHeaders() const |
| QUrl | initiator() const |
(since 6.9) bool | isDownload() 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 | [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 (since Qt 5.7) | 16 | コンテンツセキュリティポリシー（CSP）違反のレポート。CSP レポートは JSON 形式で、HTTP POST リクエストによって指定されたサーバーに配信されます。 |
QWebEngineUrlRequestInfo::ResourceTypePluginResource (since Qt 5.7) | 17 | プラグインによって要求されるリソース。 |
QWebEngineUrlRequestInfo::ResourceTypeNavigationPreloadMainFrame (since Qt 5.14) | 19 | メインフレーム・サービス・ワーカー・ナビゲーション・プリロード要求。 |
QWebEngineUrlRequestInfo::ResourceTypeNavigationPreloadSubFrame (since Qt 5.14) | 20 | サブフレームサービスワーカーナビゲーションプリロード要求。 |
QWebEngineUrlRequestInfo::ResourceTypeWebSocket (since Qt 6.4) | 254 | WebSocketリクエスト |
QWebEngineUrlRequestInfo::ResourceTypeJson (since Qt 6.9) | 21 | JSONモジュール |
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 を返します。
[since 6.9] bool QWebEngineUrlRequestInfo::isDownload() const
リクエストがユーザーからの明示的なダウンロード操作によって開始された場合、trueを返す。
この関数がfalseを返しても、ダウンロードは行われます。
この関数は Qt 6.9 で導入されました。
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 に設定する。
© 2026 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.
