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
이 열거형에는 요청된 리소스의 유형이 저장됩니다:
| Constant | 값 | 설명 |
|---|---|---|
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 | <핑>에 대한 핑 요청. |
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 | 웹 소켓 요청. (Qt 6.4에 추가됨) |
QWebEngineUrlRequestInfo::ResourceTypeUnknown | 255 | 알 수 없는 요청 유형. |
QWebEngineUrlRequestInfo::ResourceTypeJson | 21 | JSON 모듈. (Qt 6.8에 추가됨) |
참고: 역호환성을 위해 일치하지 않는 모든 값은 ResourceTypeUnknown 뿐만 아니라 알 수 없는 것으로 처리해야 합니다.
멤버 함수 문서
void QWebEngineUrlRequestInfo::block(bool shouldBlock)
shouldBlock 이 참이면 이 요청을 차단하여 진행되지 않도록 합니다.
이 기능은 예를 들어 특정 도메인에서 멀어지는 것을 방지하는 데 사용할 수 있습니다.
QUrl QWebEngineUrlRequestInfo::firstPartyUrl() const
요청의 퍼스트 파티 URL을 반환합니다. 퍼스트 파티 URL은 요청을 발행한 페이지의 URL입니다.
[since 6.5] QHash<QByteArray, QByteArray> QWebEngineUrlRequestInfo::httpHeaders() const
요청 헤더를 반환합니다.
참고: 크롬은 나중에 보안 및 프록시 헤더를 추가할 예정이므로 이 단계에서 모든 헤더가 표시되는 것은 아닙니다.
이 함수는 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.
