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() を通して送信されます。
メンバ型の説明
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 にリダイレクトします。 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)
このリクエストのリクエストヘッダname をvalue に設定します。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。